7 ms·
What hasn't been mentioned is the Zim desktop wiki: https://zim-wiki.org/ https://zim-wiki.org/ It as a lot of good ideas: It automatically creates new pages w
by jnxx 6y ago
What hasn't been mentioned is the Zim desktop wiki: https://zim-wiki.org/ https://zim-wiki.org/
It as a lot of good ideas: It automatically creates new pages when following links for which a page does not exist yet. It also allows to arrange pages in sub-pages which are grouped in folders. And, what I think is really good for organizing, is it allows to rename pages, and automatically fixes the links which are affected by this.
What I see as a disadvantage and does not fits my needs is that it uses an own markup format. I need reStructuredText / reSt markup (which can also be rendered by github), specifically for program documentation. reStructuredText is more suited for longer documentation, it has better code formatting, can show tables of contents, and is also less tied to output in a HTML page (it can easily be converted to a LaTeX or PDF document). I see a big value in being able to collect information in the same markup format as will be used for final code or API documentation, this reduces friction.
Zim allows to export reStructuredText, but currently this does only work partially.
What I use instead is a reStructuredText editor which is a Python app which is called retext (https://github.com/retext-project/retext https://github.com/retext-project/retext). It allows to enter text and preview it quickly, and to follow any links. reStructuredText also allows to view pages in a browser using restview (https://pypi.org/project/restview/ https://pypi.org/project/restview/), similar to gitit or grip for Markdown.
What I still miss is the capability to quickly create and open new links, as Zim or vimwiki can do. This is an option which is sorely missing in retext. I think for people who have similar needs but do not need the stronger structuring of reStructuredText, vimwiki is perhaps a very good option.