prototype for a flat markup language
You cannot select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
 
 
km0 e0be7f66da demo ass 1 year ago
demo demo ass 1 year ago
.gitignore flat parser 1 year ago
flat.py demo ass 1 year ago
list.1dl demo ass 1 year ago
readme.md flat parser 1 year ago
syntax.md demo assessment 1 year ago

readme.md

dlist ~ one-dimensional flat CMS

This is a prototype for a small software pubblication format. The idea is to use a single text file written as a list as Content Managment System.

The syntax of this file is really minimal, and it works together with the linear nature of the list to organize the contents. There are just a couple of level of hierarchy, hence the idea of 1D or flat structure and the .1dl extension (1-dimension list)(lame name!)

Wait, maybe 1D is just a point and to be flat one needs at least two dimensions? If so noooooo now i need to rename everything xox

(title)
[section]
--> Notes
>>comment (TBD)
Normal text

To work with some syntax highlighting i tried to set upt a file format and a syntax file for the vim text editor.

Ideally this cms could be parsed line by line, mapping for every (title) all the [sections] till the next title, as well as their contents.

The --> note tag could be used either as more chatty discussion inside the cms (that is meant to be multi-player) or to address and highlight certain parts.

Example

This is a test for the situated-doc list prototype. The idea is to write several software we developed like (padliography2) (workbook) (si16), and for each of them give an overview or a way to navigate all their scattered contents.

Blank lines should not be a problem: future parsers could just ignore them. And visually it helps to have spaces in the text file.

Here an example for the treatment of one tool, the Padliography:

(padliography2)

[what]
an interface to archive links on the wiki
mainly used for pads
several instances of the archive can be initialized
directly from the tool
so multiple archives can coexhist together

[where]
https://hub.xpub.nl/soupboat/padliography

[doc]
https://git.xpub.nl/kamo/pad-bis
https://pzwiki.wdka.nl/mediadesign/Padliography

Notes on the doc
--> Id like to see more memes, they help me understanding the process more
--> I like the toads
--> more images please!
--> I think the syntax could be more accessible by writing shorter sentences, or sentences that only focus on 1 thing. I'll elaborate after lunch

[dev]
v2 -- current
https://git.xpub.nl/kamo/pad-bis