💾 Archived View for bacaliu.de › 20220710-meta.gmi captured on 2023-07-10 at 13:17:14. Gemini links have been rewritten to link to archived content

View Raw

More Information

➡️ Next capture (2023-09-08)

-=-=-=-=-=-=-

Meta

Orgmode makes it all possible

Org-publish

I write this website in Orgmode. It's a markup-language like Markdown, but with way more capabilities. Just consider, this entire Document is exported out of it. The text I write looks like this:

 :PROPERTIES:
 :ID:       5e5e2b79-18ab-4bce-9036-b02fa0b19c91
 :END:
 #+title: Meta
 #+subtitle: About this page
 #+keywords: Meta, Orgmode, Bacaliu.de
 #+filetags: Meta Orgmode
 #+description: Why is this site so clean? Why does it need no cookies?
 #+language: en
 #+bibliography: ../ref.bib
 #+cite_export: csl ~/Vorlagen/csl/rub-eng.csl

 * Orgmode makes it all possible
 ** Org-publish
 I write this website in Orgmode. It's a markup-language like Markdown, but with way more capabilities. Just consider, this entire Document is exported out of it. The thig I write looks like this:

 #+caption: The org-file
 #+begin_src org
...

Through Org-publish (“Publishing (The Org Manual)” 2022) I create HTML, txt and gemini out of it. This is sent over to the server with git (over GitLab). I can even put programm-code inside this document and run it. I just type the code-part and the results are generated automaticly!

for i in range(3, 19, 4):
    print(f"The number {i} is one more than {i-1}")

,----

| The number 3 is one more than 2

| The number 7 is one more than 6

| The number 11 is one more than 10

| The number 15 is one more than 14

`----

Why semantics matter

Orgmode supports different markup:

If you see the html-verison you will notice: underlined text is green. I don't see the need of having /tree/ different emphasis options. How should I decide if an important word should be bold, italic or underlined? By creating a complement to struck through text, I can correct +erorrs+ _errors_ in this intuitive way. The css and my Emacs-config makes the underlined text green. But also on other exports it is somewhat intuitive that /struck-through/ text folowed by /underlined/ text means first was replaced by second.

This whole thing shows a problem with most modern content. Semantics and aesthetics are often very bound together. I have to write my own css to make sure the content looks like I want. By making headings bigger and colored I don't mean the words are literally big and colorful. I mean they are a heading and you should see it as a heading. At least html-tags are somewhat semantic-driven. When your browser reads a `<h1>Heading</h1>' it can use it to mark it big by default. But it can also give this information to a screen-reader in case you are blind or something.

Is this designed to last?

While reading in Karl Voids Blog I came across the concept of designing a website to last (“This Page is Designed to Last: A Manifesto for Preserving Content on the Web” 2022). In short: By removing possible failing-points like getting JavaScript via a CDN or hotlinking images the probability of a site loosing its functionality and information is strongly reduced.

Is my site designed to last? At least I hate CDNs for exactly this reason: I would have to trust a third party when I could just download and serve the JS myself. And it's not much anyway. Just the interactive things like weather-forecast depend on it. Anything else is just formatted text.

Targeting Org or HTML

When writing Orgmode-Documents as notes, mostly for university, I write them with the knowledge that I won't search through the documents itself. Instead I export it to HTML and view it in a browser. Some upsides about this:

On the other hand I cut actually profit from Orgmode's capabilities when e.g. searching for something, outline foldung, and such stuff.

In any case when writing /this/ it would be bad to target the HTML-output, because the parallel output as

For some reason Markdown made problems, I wish that would do it too.

Bibliography

“Publishing (The Org Manual),”. 2022. June 19, 2022, URL: , retrieved on July 10, 2022.

“This Page is Designed to Last: A Manifesto for Preserving Content on the Web,”. 2022. July 1, 2022, URL: .

Nav

Meta

Orgmode

md

txt

html

gmi

Footer

License: CC BY-4.0 [Impressum und Datenschutz]

Impressum und Datenschutz