[[2022-01-25]]

• [[Health]]
  • Had a really nast episode of [[depersonalization]] during the early morning. I'm still not 100% fully recovered from it, but I'm better.
    • Talking with my partner helped a lot. Sleeping too.
    • I think this is a sign that I should reinstate my [[meditation]] routine. It helped me a lot when these episodes were more frequent in [[2017]].
• [[Lightweight markup language]]
  • I'm trying to find an alternative for [[Markdown]] for writing the content of my site.
    • What I need in a [[lightweight markup language]] for my site:
      • As much compatibility with [[HTML]] as possible.
      • Syntax for adding anchor, semantic and arbitrary atributes to [[HTML element]]s.
      • Extensibility.
    • My options so far:

      • [[kramdown]]

          argdown
          [kramdown]: Should I use kramdown for the content of my site?
          	+ kramdown is a Markdown flavor, and Markdown is *de facto* the lightweight markup language *franca* on the internet.
          		+ I'm already used to Markdown, especially the GFM flavor.
          		- Markdown flavors' differences aren't always incremental. Sometimes their syntax for the same elements differ.
          		+ Regular textual elements are fairly easy to copy-and-paste from one Markdown flavor to another.
          			+ This is even more important when working with copying-and-pasting from one app that uses Markdown to another.
          	+ Readable.
          	+ First-class citizen on GitHub and GitLab.
          	+ First-class citizen in the Agora.
          	- Extensibility is mostly parser-dependant.
          		+ But being able to add attributes to HTML elements partially circumvents this. 
          	+ More compatible with HTML than regular Markdown.
          		- But could be better.
          	+ Jekyll supports it.  
          	+ Syntax for adding anchor, semantic and arbitrary elements to HTML elements.
          		+ <li> elements can have attributes added to them.
          		- No syntax for adding attributes to <ul> elements, which is essential for my atomic/transclusion dependant workflow.
        

      • [[AsciiDoc]] + [[AsciiDoctor]]

          argdown
          [AsciiDoc + AsciiDoctor]: Should I use AsciiDoc + AsciiDoctor for the content of my site?
          + Extensible.
          + Popular, widely used, with a rich ecossystem.
          	-  Markdown still surpasses it on the use and popularity aspect.
          + Readable. 
          + First-class citizen on GitHub and GitLab.
          + Great compatibility with HTML.
          - Not a first-class citizen in the Agora.
          	- However, there are many ways to convert AsciiDoc to Markdown.
          - Jekyll does not support it.
          	- A jekyll-asciidoc gem exists.
          		- It hasn't been updated for months.
          	- There are ways to import HTML (to which AsciiDoc can be exported) into Jekyll.
          + Syntax for adding anchor, semantic and arbitrary elements to HTML elements.
          	+ <li> elements can have id attributes added to them.
          		- Support for semantic and arbitrary attributes is yet to be implemented.
          			- There's an active discussion about implementing it however.
          	+ <ul> elements can have attributes added to them.
        

      • [[org-mode]]

          argdown
          [org-mode]: Should I use AsciiDoc + AsciiDoctor for the content of my site?
          + Extensible.
          	+ org-babel makes org-mode *really* extensible.
          + Popular and widely used desktop-wise, and part of the rich GNU Emacs ecossystem.
          	- Non-existent as an Internet lightweight markup language (it was never its purpose).
          	+ Direct integration between my private and public digital gardens.
          	- I'm a Neovim user. I don't use GNU Emacs, neither I'm really interested in using it.
          		- There are ways to use org-mode files in Neovim.
          			- However, this makes the GNU Emacs ecossystem useless.
          + Readable.
          + First-class citizen on GitHub and GitLab.
          - Not a first-class citizen in the Agora.
          	- However, there are many ways to conver org-mode to Markdown.
          - Jekyll does not support it.
          	- jekyll-org and jekyll-org-to-html exist.
          		- Both haven't been updated for years.
          	- There are ways to import HTML (to which AsciiDoc can be exported) into Jekyll.
          + Natively supported by Logseq.
          + Great compatibility with HTML.
          - Slightly more convoluted syntax than the other options.
          	- However, not in a crazy way
          + Syntax for adding anchor, semantic and arbitrary elements to HTML elements.