icnocop

View on GitHub

Projects

This user doesn't have any project on FeatHub yet.

Features suggested

Project Feature Score Description
docascode/docfx-feature-proposals "_appFooter" metadata should be considered markdown 4 I would like the "_appFooter" metadata to be considered as markdown. For example, `"_appFooter":"[Click here to download the PDF.](/_pdf/Help_pdf.pdf)"` On the main index.html, it should get rendered as: `<a href='/_pdf/Help_pdf.pdf' target='_blank'>Click here to download the PDF.</a>` Other pages should render the link relatively. So for example on /articles/SomeTopic.html, it should get rendered as: `<a href='../_pdf/Help_pdf.pdf' target='_blank'>Click here to download the PDF.</a>` Thank you.
docascode/docfx-feature-proposals Insert a "Next topic" button at the bottom of web pages to jump to the next topic and/or the next section 6 I'd like the ability to automatically insert a "Next topic" button at the bottom of web pages to automatically jump to the next topic and/ or the next section. This will allow for a better user experience when trying to read multiple topics in sequence. Otherwise I would have to manually maintain the links based on the sequence of topics, which requires duplicate work (if not more). For example, if I wanted to manually maintain "Previous topic" and "Next topic" buttons and markdown files are added, removed, or changed in the table of contents (toc.yml), I would also have to update these links in potentially multiple-related markdown files. Thank you.
docascode/docfx-feature-proposals Allow variable substitutions from parameters passed through the docfx.exe command line 6 I'd like to be able to substitute variables passed through the docfx.exe command line in both metadata and markdown. For example when I run `docfx.exe docfx.json -var { "currentYear": 2017 }`, then I expect docfx.exe to substitute all appearances of "{{currentYear}}" with "2017" in both metadata and markdown. For example, I'd like to inject the current year within "_appFooter". For example, given the following metadata: `"_appFooter" : "&copy; {{currentYear}} My Corporation."` I'd like the generated footer to contain `© 2017 My Corporation.`. This type of variable substitution should also be possible in markdown files. Thank you!
docascode/docfx-feature-proposals Ability to include a `toc.yml` file to generate a hierarchical list of links on the page 1 I'd like to be able to include a `toc.yml` file in a markdown file and have docfx generate a hierarchical list of links on the generated page. For example, given the file structure: docfx.json index.md toc.yml articles/ toc.yml topic1.md topic1a.md topic1b.md topic2.md topic3.md topic3a.md The contents of the root toc.yml: - name: Help href: articles/ The contents of articles/toc.yml: - name: Topic 1 href: topic1.md items: - name: Topic 1 a href: topic1a.md - name: Topic 1 b href: topic1b.md - name: Topic 2 href: topic2.md - name: Topic 3 href: topic3.md items: - name: Topic 3 a href: topic3a.md I would like to be able to the have a hierarchical list of links generated on the index page. For example, if index.md contains: `[!include[](articles/toc.yml)] ` I would like the generated index.html to contain something like this: <ul> <li> <a href="Topic1.html" name="" title="Topic 1">Topic 1</a> <ul> <li> <a href="Topic1a.html" name="" title="Topic 1 a">Topic 1 a</a> </li> <li> <a href="Topic1b.html" name="" title="Topic 1 b">Topic 1 b</a> </li> </ul> </li> <li> <a href="Topic2.html" name="" title="Topic 2">Topic 2</a> </li> <li> <a href="Topic3.html" name="" title="Topic 3">Topic 3</a> <ul> <li> <a href="Topic3a.html" name="" title="Topic 3 a">Topic 3 a</a> </li> </ul> </li> </ul> Thank you!

Comments

This user hasn't voted yet.

Votes

Vote When Project Feature
over 3 years ago docascode/docfx-feature-proposals "_appFooter" metadata should be considered markdown
over 3 years ago docascode/docfx-feature-proposals Insert a "Next topic" button at the bottom of web pages to jump to the next topic and/or the next section
over 3 years ago docascode/docfx-feature-proposals Allow variable substitutions from parameters passed through the docfx.exe command line
over 3 years ago docascode/docfx-feature-proposals Ability to include a `toc.yml` file to generate a hierarchical list of links on the page