Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Handle TitleIndex TracWiki Macro. #5

Open
danuker opened this issue Jan 26, 2021 · 1 comment
Open

Handle TitleIndex TracWiki Macro. #5

danuker opened this issue Jan 26, 2021 · 1 comment

Comments

@danuker
Copy link
Contributor

danuker commented Jan 26, 2021

As per #2 (comment):

See how to convert TracWiki Macros like - [[TitleIndex(Administrative/)]]

TracWiki macro [[PageOutline]] was alredy converted into the RST content directive: .. contents:: in #9

See how to update the _Sidebar.rst to also include the list of last N modified pages, to get the same functionality as Trac.


Suggestion from Dan: In order for TitleIndex macros to be more useful, a script should run regularly (say, every time the wiki is updated) and update the file lists, instead of just once, at importing.

@adiroiban
Copy link
Member

Suggestion from Dan: In order for TitleIndex macros to be more useful, a script should run regularly (say, every time the wiki is updated) and update the file lists, instead of just once, at importing.

Yes. i was thinking of creating some helper python script, hosted inside the wiki repo to inject per-file footers.

Note that the GitHub wiki supports a general sidebar and footer that is show on all pages.

In RST, you can use the RST comments to mark the start of the footer. The script can then check each file, remove the current footer and inject a new one.

The RST comment can look like this.


.. footer-start-marker


For pageoutline, just a script that adds the page TOC at the very top.

Thanks

@adiroiban adiroiban changed the title Handle TracWiki Macros Handle TitleIndex TracWiki Macro. Feb 12, 2021
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

No branches or pull requests

2 participants