{{ex}}\r\n \r\n\r\n\r\n```\r\n\r\nThe example is rather contrived and will not work with such a resolving. But maybe it will come in handy for something.\r\n\r\n## Syntax\r\n\r\nThe default syntax is: `#{key-word}%`, `#{resolve-alias key=\"\" path=\"\"}%`\r\n\r\n- `#{` -- opening capture tag\r\n- `}%` -- closer capture tag\r\n\r\nYou can change default template syntax if add `tStart` and `tEnd` params in configuration:\r\n\r\n```javascript\r\n// vite.config.js\r\nimport { defineConfig } from 'vite';\r\nimport transformPlugin from 'vite-plugin-transform'; // Look at me!\r\n\r\nexport default defineConfig({\r\n plugins: [\r\n transformPlugin({\r\n tStart: '%{',\r\n tEnd: '}%',\r\n // ...other options here...\r\n })\r\n ]\r\n});\r\n```\r\n\r\nAfter this config changes you should use something like this:\r\n\r\n```javascript\r\n console.log('Hello %{friend}%!');\r\n console.log('%{resolve-alias path=\"@\" path=\"aaaa/bbb/sdsd\\cfdf/weq\\qwe\"}');\r\n //see Examples section\r\n```\r\n\r\n## Exclude\r\n\r\nTo exclude some paths from processing, you can write the `exclude` key with an array of values in the config, which, if found in the file path, will be ignored.\r\n\r\n```javascript\r\n// vite.config.js\r\nimport { defineConfig } from 'vite';\r\nimport transformPlugin from 'vite-plugin-transform'; // Look at me!\r\n\r\nexport default defineConfig({\r\n plugins: [\r\n transformPlugin({\r\n // You can use regexp, because under the hood, this is used\r\n // new RegExp(excludePattern, 'igm').test(id)\r\n exclude: ['node_modules', 'app.js']\r\n // ...other options here...\r\n })\r\n ]\r\n});\r\n```\r\n\r\n## Replace words\r\n\r\nFor simple word replacement in project files, add `replace` object with keys and values for replacement:\r\n\r\n```javascript\r\n// vite.config.js\r\nimport { defineConfig } from 'vite';\r\nimport transformPlugin from 'vite-plugin-transform'; // Look at me!\r\n\r\nexport default defineConfig({\r\n plugins: [\r\n transformPlugin({\r\n tStart: '%{',\r\n tEnd: '}%',\r\n replace: {\r\n 'robot': '🤖',\r\n 'smile': '😀',\r\n 'up-vote': '👍',\r\n }\r\n })\r\n ]\r\n});\r\n```\r\n\r\nIn your working files, you can use code like this, then:\r\n\r\n```javascript\r\n// AppForMakePeaceAndHappy.vue\r\n\r\n Hello %{smile}%!
\r\nLook at the %{robot}%.
\r\n \r\n\r\n\r\n```\r\n\r\n## Replace words alternative\r\n\r\nFor ~~simple~~ word replacement in project files, you can use a plugin with parameters similar to the following in the `vite.config.js` configuration file:\r\n\r\n```javascript\r\nimport { defineConfig } from 'vite';\r\nimport transformPlugin from 'vite-plugin-transform'; // Look at me!\r\n\r\nexport default defineConfig({\r\n plugins: [\r\n transformPlugin({\r\n callbackArray: [\r\n str => str.replace(/Logout!/igm, 'Goodbye!'),\r\n str => str.replace(/Another world/igm, 'Another replaced world'),\r\n str => str.replace(/again/igm, 'and again'),\r\n ]\r\n })\r\n ]\r\n});\r\n```\r\n\r\nAs you can see in the example, we add functions to the `callbackArray` array that take a string and return a string, with your possible data modification already.\r\n\r\nHowever, it is worth noting that the replacement will be made only of those data that will be found in the files, in other words, reactive data, variable values will not be processed. It's pretty obvious, but don't forget about it.\r\n\r\n## How to process bundle files\r\nYou may want to treat a file located in the public directory, as well as content that is replaced in the application. To do this, add the \"replaceFiles\" parameter, the value of which will be an array with the paths of the files you need to change.\r\n\r\nExample:\r\n```javascript\r\n// vite.config.js\r\n// see Examples section\r\n//..\r\nconst replaceFiles = [\r\n resolve(join(__dirname, './dist/data.xml')),\r\n resolve(join(__dirname, './dist/data-notimported.xml')),\r\n];\r\n//..\r\nexport default ({ mode }) => {\r\n return defineConfig({\r\n plugins: [\r\n vue(),\r\n XMLLoader(),\r\n transformPlugin({ \r\n tStart: '{%', tEnd: '%}',\r\n replaceFiles\r\n }),\r\n ],\r\n// ...\r\n```\r\n\r\n## Examples\r\nVisit the repository with examples: https://github.com/Silksofthesoul/vite-plugin-transform-examples\r\n\r\n## Difference between versions 1.x.x and 2.x.x\r\n### Resolve alias\r\n- v1.x.x: #{resolve_aliace}%@lib#{/end}%/abc\r\n- v2.x.x: #{resolve-alias key=\"@lib\" path=\"abc\"}%\r\n\r\n## Contribution\r\n\r\nI will be glad if you inform me about [bugs][issues], [wishes][issues], or make a [Pull Request][pr].\\\r\n...Or you can improve this document and correct literary and semantic mistakes that I could have made.\\\r\nFeel free.\r\n\r\n[git]: https://github.com/Silksofthesoul/vite-plugin-transform\r\n\r\n[npm]: https://www.npmjs.com/package/vite-plugin-transform\r\n\r\n[issues]: https://github.com/Silksofthesoul/vite-plugin-transform/issues\r\n\r\n[pr]: https://github.com/Silksofthesoul/vite-plugin-transform/pulls\r\n","readmeFilename":"README.md"}