On 1/14/2017 10:16 AM, Chris Green wrote:
On 1/14/2017 6:40 AM, Chris Green wrote:
[snip]
reStructuredText is a markup laguage (i.e. it's similar to Markdown)
but is designed for the job. It's quite readable in its native form
and has conversion software for (I think, I haven't actually checked)
HTML, LateX and others.
See:- http://docutils.sourceforge.net
I use it quite a lot for writing my own documentation and notes.
I picked up on that you use it for writing notes.
I have been looking for a note taking tool. A requirement is that it has
some sort of hyperlinking capability. I've yet to come across anything
personally attractive.
reStructuredText can do hyperlinks but if you think about it
hyperlinks in text are rather difficult to tie down.
*GRIN* That's why I hadn't found a satisfying candidate.
It depends a lot
on the context how the hyperlink should work.
The link you gave points to low level detail information.
It conceals what I'm looking for.
Yes, I'm aware that the reStructuredText 'home' pages drop you in at
rather a low level.
There's a rather more 'user friendly' entry point at:-
http://docutils.sourceforge.net/rst.html
It has two links which provide effective propaganda.
http://docutils.sourceforge.net/docs/user/rst/quickstart.html
http://docutils.sourceforge.net/docs/user/rst/quickstart.txt
The key portion of the later is:
"The `What Next?`_ section below has links to further resources,
including a formal reference."
That demonstrates generating >90% of the instances of hyper
linking I would need.
Off page references appear to be as simple.
I use Debian. What should I "apt-get install" to produce a
similar document. I perhaps take the ideal of "minimal footprint"
to an extreme ;/
To use a (possibly) poor analogy, I'm looking for a page written by
"marketing" rather than "engineering". It would likely be in a format that
would be natural for Wikipedia.
There is a Wikipedia entry too:- https://en.wikipedia.org/wiki/ReStructuredText
--
xubuntu-users mailing list
[email protected]
Modify settings or unsubscribe at:
https://lists.ubuntu.com/mailman/listinfo/xubuntu-users
