![]() You can define external reference patterns in your duly-noted.json in the format:Īdding an external link to a comment works just like adding an internal link - with one major change - the :: in external reference path will be replace in order by items in the link.įor example, using in a comment will link to: If you have an idea of how to better handle this anchor business please leave a comment on Issue #4. Note that BitBucket does not currently support html inline, so you are best to just set these both to false and add your voice to the legion of folks who requested they support some basic html in Markdown docs. If you would rather not muddle your Markdown with 's at all then set both to false, and anchors will not be modified, but simply printed out. To insert plain-jane HTML tags as anchors set markdownGeneratorOptions.htmlAnchors = true. To insert tags that will work as anchors in GitHub set markdownGeneratorOptions.gitHubHtmlAnchors = true in your duly-noted.json file. Supports 's as HTML in-line with the Markdown. Markdown does not natively support the creation of such anchors, however, there are some work-arounds if you are hosting (rendering) on GitHub, or your viewer You can link to another place in your source comments as follows: Set to true to insert html anchor tags in your markdown to support "#" links.ĭuly Noted allows you to create both internal and external links. Only use if you are hosting docs in GitHub. Set to true to support anchor tags in GitHub. Object for setting specific settings for Markdown Generator If you want to leave these files undeleted, set this to true. When it is done, it cleans up these json files automatically. Currently html and markdown are available.ĭuly Noted parses your code files to a json map of comments and code. ![]() The default link start is so to link to anchor above: of External Reference objects, each with an anchor and a path.Īrray of generators you want to use to generate output. The regular expression to use to identify links. ![]() The default anchor start is !, as in !ImAnAnchor The regular expression to use to identify anchors you want to be able to link to. For markdown + GitHub README.md can be helpful, as it auto-renders.ĭirectory where documentation should be output. Output documentation index/homepage name. The input code files you want to document with Duly Noted.
0 Comments
Leave a Reply. |