mkdocs-semiliterate is _too_ eager to extract #17

New Issue

glen · 2022-07-12T16:03:32Z

glen commented

2022-07-12 16:03:32 +00:00

The simple/semiliterate option include_extensions specifies files that should be copied into the documentation site unchanged. And by default, mkdocs-semiliterate scans all files for /** md ... */ markdown. But the effect of the latter is to first try to scan the files that will be copied, typically failing or warning, before going ahead and copying them unchanged. The precedence should be changed so that files to be copied are handled first and exclusively by copying, only giving semiliterate markdown extraction a crack if they are not to be copied unchanged.

The simple/semiliterate option `include_extensions` specifies files that should be copied into the documentation site unchanged. And by default, mkdocs-semiliterate scans all files for `/** md ... */` markdown. But the effect of the latter is to first try to scan the files that will be copied, typically failing or warning, before going ahead and copying them unchanged. The precedence should be changed so that files to be copied are handled first and exclusively by copying, only giving semiliterate markdown extraction a crack if they are not to be copied unchanged.

glen referenced this issue from a commit

2022-07-12 19:19:51 +00:00

feat: Add `extract_on_copy` option

glen referenced a pull request that will close this issue

2022-07-12 19:22:36 +00:00

feat: Add `extract_on_copy` option #18

glen closed this issue

2022-07-12 19:32:40 +00:00

Sign in to join this conversation.