I generally like working with reStructuredText for technical documentation. I use it a lot both at work and on my own projects.
But the little detail that a single space off on the indentation turns something into a block quote, which happens *all the time* in lists with sub points, is rather annoying. They should have stuck with ">" for block quotes instead.
I see these accidental block quotes all the time in documentation.
release pandoc 3.7
Features:
• New option `--variable-json`. Structured variable values can now be passed via the command line.
• Rowspans and colspans are supported in grid-table output (#Markdown and #RST).
• Improved handling of inline TeX in #orgmode.
• #Lua subsystem: the `pandoc.read` function can now be used in “sandboxed” mode, restricting file or network access.
Please see the changelog for the full list of changes and bugfixes.
https://github.com/jgm/pandoc/releases/tag/3.7
Should I dare to do a "why #Markdown is one of the worst lightweight markup syntax languages there is"-session at a UX/UI-dominant #barcamp?
C'mon, do push me over that cliff!
Background: https://karl-voit.at/2017/09/23/orgmode-as-markup-only/ it's related but would be a different focus since I won't push #orgdown that much - people can be happier with other LMLs as well as long as it's not the #MD hell. (Sneak preview: I'm writing a long article on all the MD issues in order to explain it once and for all since the Mastodon discussions are really annoying to me.)
Mal eine Frage an die #Linux bzw. #Ubuntu Bubble: Ich möchte Ubuntu24.x auf meiner SDD installieren. Derzeit ist windows11 drauf. D.h. eigentlich will ich künftig via grub Bootmanager entscheiden, welches Betriebssystem starten soll (win11 brauche ich noch für einige wenige gekaufte Anwendungen, die ich noch nicht mit wine getestet habe).
----
Nun mein Problem: Ubuntu verlangt im Installationsprozess, dass die Intel RST ausschalte.
----
Wenn ich aber im Web surfe, dann wird vor Datenverlust gewarnt und ich möchte eigentlich nicht mühsam dann win11 neu von irgendeinem Backup wieder einspielen, wenn das am Ende nicht beides parallel läuft. Die von win11 angebotene Installation mit Ubuntu unter win11 ist mir unsymphatisch, da MS immer mehr versucht, alles zu dominieren und ich keine Lust habe, mir dieses Verhalten auf die Dauer gefallen zu lassen (Outlook 2016 soll künftig nicht mehr Mails empfangen können, das Betriebssystem will ungefragt Screenshots erstellen und für das KI-Training nutzen usw....).
Hat jemand von Euch schon mal Intel RST ausgeschaltet, ohne dabei Daten zu verlieren und alles wieder mühsam zurückzusichern?
#Intel #RST #windows11
Actually, this really looks well! I have never been able to manage to write #groff documents, but this looks really well with plain #reStructuredText (or #rst) documents.
@pludikovsky When people are in favor of #Markdown, they either do mean the concept of lightweight #markup languages (#LML) in general (yeah!) or they do not really know many other LMLs in comparison.
Furthermore, people voting for MD often do ignore the obvious downsides of that ecosystem because they have already overcome some of them, ignoring the majority of people who still need to learn that LML in future.
Aside from the comment about #Firenvim, I really don’t care about Mastodon, Facebook, Reddit and similar ephemeral stuff. What is relevant is written in my $EDITOR as #rST and then published on my #blog (https://matej.ceplovi.cz/blog/category/computer.html).
#RST stellt ein:
Ab sofort bieten wir am Standort in Mönchengladbach einen attraktiven #Arbeitsplatz in einem dynamisch wachsenden #Familienunternehmen als #Mitarbeiter (m/w/d) im #technischen #Einkauf in Vollzeit (40 Std.) an.
Wir bieten: #unbefristeter #Arbeitsvertrag
angenehmes Betriebsklima in einem Team aus qualifizierten und motivierten Mitarbeitenden
Fort- und Weiterbildungen
Mitarbeiterbenefits
umfassende Einarbeitung
Alle Infos unter: www.rst.eu/karriere
i feel like there was trend towards #markdown in web services and apps a few years ago (like #slack, #trello, #discourse, etc.), and now there's a trend towards faking markdown as a shortcut in some sort of bespoke rich text formatting system, and it's never as flexible as markdown, and it's never the same twice, and it's really bugging me
just let me use markdown. or #rst! i don't care. either of those is fine. please? you're not freaking google docs, i'm not building a pdf, i just want to put lists in blockquotes. your reinvention of the wheel is terrible, just use a regular wheel.
#RST sucht Dich:
Zum 1. August 2023 bieten wir am Standort in Wallenhorst einen abwechslungsreichen und attraktiven #Ausbildungsplatz zur #Fachkraft für #Lagerlogistik m/w/d an.
Wir bieten Dir: einen unbefristeten Arbeitsvertrag nach erfolgreichem Abschluss der Berufsausbildung
intensive Begleitung und regelmäßiges Feedback während deiner Ausbildung
Getränkeflat u.v.m.
Alle Infos unter: www.rst.eu/karriere
RST – connected by competence
Starting with #pandoc 2.19, #reStructuredText-style grid tables can contain advanced table features, including multi-row headers and cells that can span across rows and columns.
#GridTables work with #Markdown, #RST, and #OrgMode input.
#reStructuredText follows the logic that underlined text means that it's a link, so it doesn't have dedicated syntax for (non-link) underlined text either. Support can be added with this syntax
.. role:: underline
:class: underline
:underline:`this`
in combination with a short #LuaFilter
function Span(s)
return s.classes[1] == 'underline' and pandoc.Underline(s.content) or nil
end
#Orgdown (= #OrgMode Syntax) Is One of the Most Reasonable #Markup Languages to Use for Text https://karl-voit.at/2017/09/23/orgmode-as-markup-only/
Irreal: A Discussion of #Markup Languages
https://irreal.org/blog/?p=10922
#rst2pdf is a #rST to #PDF converter.
rst2pdf compiles #reStructuredText into PDF files. rst2pdf supports all of the regular directives from rST, but adds syntax highlighting, counting index numbers, and a subset of LaTeX. rst2pdf's page formatting, quote characters, etc., are controlled using a configuration file and stylesheets. rst2pdf supports extensions.
Website ️: https://rst2pdf.org/
apt ️: rst2pdf
I wonder whether #emacs has a preview-mode for #rst #reStructuredText
@sheogorath
After using #reStructuredText for many years: What I really love about #markdown is that there are so many standards.
#Formiko is a #reStructuredText (#RST) and #Markdown editor.
Formiko is a text editor with support for text highlighting and live rendering using various backends. Formiko supports RST and Markdown, and can render formatted text to either HTML or JSON. Formiko features autosaving as well as spellchecking to make editing easier.
Website ️: https://github.com/ondratu/formiko
apt ️: formiko