journaltxt.github.io

Journal.TXT @ GitHub

Journal.TXT - Single-Text File Journals - The Human Multi-Document Format for Writers

Write your journal in a single-text file. Example:

--- 
year:  2017
month: July
day:   Wed 19
---
Let's reinvent push-button publishing on the internets! 
Use a single-file for your journal / diary / blog. That's it.
---
day:   Thu 20
---
Crazy idea? Let's put up a website and a example blog auto-generated from journal.txt.
---
day:   Fri 21
---
Did you know? The single-file format works great for advent calendars 
or beer-of-the-day calendars.
---
day:    Sat 22
---
Let's add another example. A diary about the Oktoberfest 2016. Prost. Cheers.
---
day:    Sun 23
---
Let's rest.

How does it work?

The single-text file is a series of meta data and text blocks.

Dates

Use the meta data block for adding the date. In the first meta data block you need a “full” date, that is, year/month/day e.g.:

year: 2017
month: July
day:   Wed 19

or

date: 2017-07-19

In the following entries you only need to add what changes e.g. still in the same month as yesterday? just add a day entry (and the computer will calculate the full date) e.g.:

day: Thu 20

or

day: 20

Use any of these date entries:

Bonus: Add the year or month to the file name. If you use a filename in the YYYY-MM-title.txt or YYYY-title.txt or format than journal.txt will auto-add the year (and month) from the filename.

Titles

Note: You do NOT need a title for you entries and you do NOT need a title for your journal (use journal.txt if you like).

If you use a differnt name e.g. austria.txt or 2017-oktoberfest.txt than journal.txt will auto-add the title from the filename.

By default the journal entries get auto-titled. Example:

If you add a title - the title by default gets added e.g.

Note: You can always customize the title format. FUTURE (To be done).

Bonus: Single-Source for Blog Posts & Status Tweets / Toots

You can add tweets (or toots) to your journal.TXT. Use a “generic” block in the Text with Instructions (.texti) format. Example:

:::::: Tweet :::::::  
:: New! Journal.TXT - Single-Text File Publishing - 
:: The Human Multi-Document Format for Writers - Blogging Reinvented https://journaltxt.github.io  

or use the “long” block form:

:::::: Tweet ::::::::::::
New! Journal.TXT - Single-Text File Publishing - 
The Human Multi-Document Format for Writers - Blogging Reinvented https://journaltxt.github.io
::::::::::::::::::::::

If configured your Journal.TXT processor will publish (auto-build) your blog AND publish your (new) tweets (on twitter) all from a single-text source file, for example.

Jounal.TXT @ GitHub

Journal.TXT Samples

Single-Text File Journals - The Human Multi-Document Format for Writers

A Perfect Day in ___?

samples/Vienna.txt:

---
year:  2017
month: July
day:   Mon 17
---

Jumping on tram #1 in front of the Staatsoper (state opera house). 
Circling the Ringstrasse (grand boulevard vienna ring road) 
for a great tour with a public transport ticket.
Passing the Hofburg (imperial palace), Parlament, 
Burggarten (imperial court's garden), 
Rathaus (city council), Burgtheater (imperial court's theatre),
Vienna University, and more. [...]

---
day:   Tue 18
---

Visiting the imperial palace Schönbrunn - the former summer residence
of the Habsburg family.
Taking an inside tour of the 1 441-room baroque palace.
Enjoying the Neptune Fountain and sculptures in the public garden. [...]

---
day:   Wed 19
---

Visiting the Sigmund Freud Museum in Bergstrasse 9. Too much culture - 
need a beer therapy soon.
Passing through the Palais Lichtenstein to the
Beaver Brewing Co. (Liechtensteinstraße 69). [...]

See the live auto-built Vienna.TXT Blog »

Add Your Perfect Day!

Berlin.TXT, Munich.TXT, Salzburg.TXT, Paris.TXT, London.TXT, Rome.TXT, New York.TXT, Austin.TXT, Tornoto.TXT, Calgary.TXT, Melbourne.TXT, Sydney.TXT, … - Anyone? Write your perfect day(s) in a single-text file with Journal.TXT.

License

The Journal.TXT format and conventions are dedicated to the public domain. Use it as you please with no restrictions whatsoever.

Questions? Comments?

Send them along to the wwwmake mailing list/forum. Thanks.