{"id":22160249,"url":"https://github.com/silencesys/dh--xlsx-to-xml","last_synced_at":"2026-08-12T13:31:32.976Z","repository":{"id":57160239,"uuid":"407932755","full_name":"silencesys/dh--xlsx-to-xml","owner":"silencesys","description":"Convert simple two column XLSX to kind of XML.","archived":false,"fork":false,"pushed_at":"2021-11-11T13:59:48.000Z","size":46,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-10-06T01:55:43.598Z","etag":null,"topics":["converter","xlsx","xlsx-to-xml","xml"],"latest_commit_sha":null,"homepage":"https://www.npmjs.com/package/@silencesys/xlsx-to-xml","language":"JavaScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/silencesys.png","metadata":{"files":{"readme":"readme.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2021-09-18T18:04:36.000Z","updated_at":"2021-11-11T14:05:17.000Z","dependencies_parsed_at":"2022-09-09T07:00:55.186Z","dependency_job_id":null,"html_url":"https://github.com/silencesys/dh--xlsx-to-xml","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/silencesys/dh--xlsx-to-xml","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/silencesys%2Fdh--xlsx-to-xml","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/silencesys%2Fdh--xlsx-to-xml/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/silencesys%2Fdh--xlsx-to-xml/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/silencesys%2Fdh--xlsx-to-xml/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/silencesys","download_url":"https://codeload.github.com/silencesys/dh--xlsx-to-xml/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/silencesys%2Fdh--xlsx-to-xml/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":36565295,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-08-06T04:43:03.162Z","status":"online","status_checked_at":"2026-08-12T02:00:07.134Z","response_time":57,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["converter","xlsx","xlsx-to-xml","xml"],"created_at":"2024-12-02T04:07:00.022Z","updated_at":"2026-08-12T13:31:32.959Z","avatar_url":"https://github.com/silencesys.png","language":"JavaScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# XLSX to XML\n\nThis little tool converts two column XLSX Excel files to XML.\n\n\u003cbr\u003e\n\n## How to use\n\n1. Install this package with NPM\n```bash\nnpm install -g @silencesys/xlsx-to-xml\n```\n2. Create config file that will be used for the transformation\n3. Run the tool\n```bash\nxlsx-to-xml --input your_input_file.xlsx --output your_output_file.xml --config your_config.json\n```\n\n\u003cbr\u003e\n\n### Available options\n| Option | Description |\n| ------ | ----------- |\n| --input, -i | The input file to be converted to xlsx |\n| --output, -o | The output file to be created |\n| --config, -c | The config file that will be used |\n| --dirty | Set this flag if you want to see XHTML tags added by XLSX transformer |\n| --ignore-halves | Set this flag if you want to ignore rows that has one column empty |\n| --help, -h | Show help |\n\n\u003cbr\u003e\n\n## Config file\nThe config file is a standard JSON file with following structure:\n```json\n{\n  \"parentTagName\": \"dictionary\",\n  \"rowTagName\": \"entry\",\n  \"language\": [\"eng\", \"cze\"],\n  \"stripTags\": [\n    \"\u003cspan style=\\\"font-size:12pt;\\\"\u003e\"\n  ],\n  \"replaceTags\": [\n    {\n      \"from\": \"\u003cspan style=\\\"font-size:9pt;\\\"\u003e\",\n      \"to\": \"\u003cnote\u003e\"\n    },\n  ],\n  \"divideBy\": [\n    [\": \"]\n  ]\n}\n```\nAs you can see there are several options that can be used. **There is no default config file as each use case is expected to be unique.** You can use aforementioned snippet as your default config file.\n\n| Option | Required | Description |\n| ------ | :--: | ----------- |\n| `parentTagName` | Yes | Name of the parent tag. |\n| `rowTagName` | Yes | Name of the row tag. |\n| `language` | Optional | List of languages that should be used. |\n| `stripTags` | Optional | List of tags that should be stripped from the text. The list should contain only opening tags with all their attributes that should be removed. |\n| `replaceTags` | Optional | List of tags that should be replaced. These tags should always be defined as a JSON object containing keys `from` and `to`. Only opening tags but with all attributes should be defined there. |\n| `divideBy` | Optional | List of strings that should be used to divide the text. _You might want to include spaces following after these characters as the division method is quite dumb_.  |\n\n\u003cbr\u003e\n\n### How to write a config file\nI'm sure you ask how am I supposed to know which XHTML tags will be used in my XLSX document after conversion. Well, for that purpose there is a very simple way. Just run following command:\n```bash\nxlsx-to-xml --input your_input_file.xlsx --dirty\n```\nThis will output a _dirty_ file containing XML with all XHTML tags. You can then decide which tags should be stripped or replaced and which should be kept. Just keep in mind that tags `\u003cdirty-list\u003e` and `\u003cdirty-row\u003e` are added by this tool and will be replaced by `parentTagName` and `rowTagName` respectively.\n\n\u003cbr\u003e\n\n## Contributing\nAll the code is open source and you can contribute to the project by creating pull requests.\n\n\u003cbr\u003e\n\n## License\nThis project is licensed under the [MIT license](LICENSE.md).\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsilencesys%2Fdh--xlsx-to-xml","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fsilencesys%2Fdh--xlsx-to-xml","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsilencesys%2Fdh--xlsx-to-xml/lists"}