> On Friday, February 7, 2020 at 12:00:43 AM UTC-5, Thomas Passin wrote:
>>
>>
>>
>> On Thursday, February 6, 2020 at 11:04:30 PM UTC-5, andyjim wrote:
>>>
>>> attached is my first draft for a zettel format.  
>>>
>>
>> Thanks.  Here's my first cut at a format. 
>>
>
Here is a Restructured Text version that uses RsT syntax features.  I think 
this is the best I've come up with so far.  Attached is the text file and 
an HTML file showing how it looks rendered by an RsT processor.

This format is nearly as easy to type and read in plain text as the 
original plain text version, uses only standard RsT features, and is very 
readable when rendered to HTML.

-- 
You received this message because you are subscribed to the Google Groups 
"leo-editor" group.
To unsubscribe from this group and stop receiving emails from it, send an email 
to [email protected].
To view this discussion on the web visit 
https://groups.google.com/d/msgid/leo-editor/2d35b3ce-31f4-4952-8d75-2a87f5409bf8%40googlegroups.com.
:title: expermental zettel format 3
:id: t-zformat-3
:index-term: zettel/format
:parent: t-zformat-2
:date: 2020/2/5
:format: rst

.. this is a comment line, using the RsT line comment marker.
.. Keywords are delineated with colons(:).
.. :order of these keyword entries is not important.
.. :cite: for citations to published sources
.. :url: for URLs to relevant web pages.
.. :rel: for relations to other zettels.
.. :child: id of child zettel.
.. :time: 1830
.. Body of note is not introduced by any identifier.
.. All data items are optional.

This format is basically the same as Format 2, except that the keyword lines 
start with a colon (:).  RsT automatically renders them in a nicely readable 
way.  Also, comments are delineated using the RsT comment marker ("..").

Note that Markdown does not have a convenient syntax for the inline keyword 
lines or for comment lines.  This makes me think that Restructured Text is the 
best way to go for zettels.

**Pros**: Uses only standard RsT syntax.

**Cons**: *Slightly* more typing for the keywords and comments, compared with 
plain text format version.


Title: format_4.txt

format_4.txt

title:expermental zettel format 3
id:t-zformat-3
index-term:zettel/format
parent:t-zformat-2
Date: 2020/2/5
format:rst

This format is basically the same as Format 2, except that the keyword lines start with a colon (:). RsT automatically renders them in a nicely readable way. Also, comments are delineated using the RsT comment marker ("..").

Note that Markdown does not have a convenient syntax for the inline keyword lines or for comment lines. This makes me think that Restructured Text is the best way to go for zettels.

Pros: Uses only standard RsT syntax.

Cons: Slightly more typing for the keywords and comments, compared with plain text format version.

Reply via email to