Repository navigation
Extend --include-fragments docu #2278 - #2281
Conversation
A first draft, including the info I would want to see
katrinafyi
left a comment
There was a problem hiding this comment.
If you have it checked out locally, you can run make readme to generate the new README text and fix the failing test. If not let me know and I can do it.
| /// This check will not work on all URLs. | ||
| /// The rough requirements are, that the target content be Markdown or HTML, | ||
| /// and that it follows certain, common conventions. | ||
| /// If for example JavaScript needs to be executed | ||
| /// to get to the actual HTML content that might contain the anchor, | ||
| /// the check will not see the anchor (e.g. report a miss), | ||
| /// as this scenario would require running this checker to run a browser engine, | ||
| /// which would make it orders of magnitude heavier on computing resources. | ||
| /// More info about this check can be found here: | ||
| /// <https://lychee.cli.rs/recipes/anchors/> |
There was a problem hiding this comment.
Makes sense. I shortened it a bit because we don't have to justify ourself in the help text. I think this limitation is very reasonable and unsurprising.
I also don't feel a strong need to list markdown + HTML. id attributes are fundamentally a HTML thing so other file types don't usually make sense. We support Markdown because Markdown is often converted to HTML. It's also in the linked page, but if you feel strongly about this it can be added back.
| /// This check will not work on all URLs. | |
| /// The rough requirements are, that the target content be Markdown or HTML, | |
| /// and that it follows certain, common conventions. | |
| /// If for example JavaScript needs to be executed | |
| /// to get to the actual HTML content that might contain the anchor, | |
| /// the check will not see the anchor (e.g. report a miss), | |
| /// as this scenario would require running this checker to run a browser engine, | |
| /// which would make it orders of magnitude heavier on computing resources. | |
| /// More info about this check can be found here: | |
| /// <https://lychee.cli.rs/recipes/anchors/> | |
| /// If enabled, this check will only succeed if the anchors exist in the | |
| /// static content of the target page (e.g., it will not run JavaScript). | |
| /// See also: <https://lychee.cli.rs/recipes/anchors/> |
as suggested by @mre Co-authored-by: Matthias Endler <[email protected]>
|
Thanks for the contribution @hoijui. |
|
Thank you for the tool and the process; was a pleasure! |
A first draft, including the info I would want to see