@mirabilos @joel @tilvids @sotolf @benjaminhollon @thelinuxcast

I actually really like #markdown, mostly because it's little more than a distillation/refinement of some wiki formats I've used in the past, like #WikkaWiki and older versions of @TiddlyWiki (which I really loved).

But no, TeX, it ain't. It's not even trying to be @mediawiki.

There are definitely better formats if precision is a goal. Maybe #ReStructuredText? (I really don't know anything about it).

#TIL: There is something like "anonymous hyperlinks" in ReStructuredText.

https://jugmac00.github.io/til/anonymous-hyperlinks/

#rst #ReStructuredText #Python

reStructuredText texto re-estrucuturado

#Blog #plaintext #reStructuredText #rst #TextoPlano

https://osiux.com/restructuredtext-texto-re-estructurado.html

⦿ Switch to #reStructuredText, which has always had auto-numbering of items in an ordered list

@accessrel

ReText: Ein einfacher Markup-Editor

ReText ist ein leichtgewichtiger Editor. Er erleichtert das Arbeiten mit Markdown und reStructuredText.

#markdown #reStructuredText #ReText #Editor #Schreiben #Linux

https://gnulinux.ch/retext

Crear una libreta artesanal A7 para capturar ideas en papel

#A7 #Artesanal #Blog #hispterPDA #Libreta #Moleskine #papel #Pocketmod #reStructuredText

https://osiux.com/capturar-ideas-en-papel-de-moleskine-hispterpda-pocketmod-y-libreta-artesanal.html

Inter-Project #Documentation Rendering Code Sprint: On 20 and 21 April 2023, members of at least four open-source projects will meet at the TYPO3 office in Düsseldorf, Germany, to bring #PHP-based #reStructuredText parsing forward.

https://typo3.org/event/20230420-inter-project-documentation-rendering-code-sprint

#typo3 #symfony #doctrine #phpdocumentor

@colepeters @remotesynth

There are parallels here for tech writers too, with #FrameMaker, #DocBook, #AsciiDoc, #ReStructuredText or #DITA.

Each tool we learn teaches us something about the others.

Alabaster is now officially part of the sphinx-doc Github org! 🎉 https://github.com/sphinx-doc/alabaster

I'll still keep my fingertips in, but hopefully this removes me as a _bottleneck_ for development.

Big thanks to Adam Turner (AA-Turner on GH) for shepherding the process ❤️

#Python #Sphinx #documentation #Alabaster #ReStructuredText

If is anyone that uses Sphinx for technical documentation and wants pretty timelines, I think I've found the extension!

https://sphinx-timeline.readthedocs.io/en/latest/

I'm giving it a try today and will report back if there are any major hiccups.

https://sphinx-timeline.readthedocs.io/en/latest/

#sphinx #restructuredtext #rst

#Markdown #AsciiDoc #reStructuredText #DocsAsCode #TechnicalWriting: "In the first part of my docs-as-code series, I’ll talk about the choice of markup languages, the available frameworks, and do a comparison among Markdown (md), Asciidoc (adoc), and reStructuredText (reST) based on some use cases. I’ll skip the history but in case you’re interested, my friend and colleague Tibs delivered a talk on the history of text markup languages. My hope is to provide you with a detailed analysis of these choices of markup languages and frameworks so that you can make an informed decision when selecting one for your next developer documentation project. If you don’t need a brief intro and would like to skip the appetizer, you can go straight to the entrée - Choose the right markup section."
https://www.dewanahmed.com/markdown-asciidoc-restructuredtext/

What is a better simple #text #markup language (both are extendable) ?

1) #restructuredtext brings file inclusion
2) #makrdown has public inclusion as it is popular in the striving RoR community

:troll:

What is a better simple markup language (both are extendable) ?

1) #restructuredtext brings file inclusion
2) #makrdown has public inclusion as it is popular in the striving RoR community

:troll:

I'm now getting the crazy idea of integrating #reStructuredText into my notes-website.

I wonder how hard it would be.

Is there a way to enable #reStructuredText syntax highlighting in #Python docstrings in #IntelliJ / #PyCharm?

#ShowerThoughts could the #PlainText format wars be nullified by a configurable parser for formatted text, with a canonical form for its configuration?

The configuration could be simpler than a parser grammar, given the plain-text context - it could be a specification of the sigils for different sections of text. Given configurations for standard #Markdown #ASCIIdoc #ReStructuredText , it would be easy to parse variants by patching the configuration since it would be in a canonical form.

The changelog for this monster release is over 1000 lines long. Highlights:
- `pandoc lua` works as a #LuaLang interpreter;
- `pandoc server` starts #pandoc as a server;
- The new "chunkedhtml" format generates paged, book-like output;
- Support for [[wikilinks]] and ==highlighting== in #Markdown (both hidden behind extensions);
- Better support for complex #figures;
- list tables for #reStructuredText output;
- and much more.

@Amirography My résumé is maintained as a #reStructuredText document, that I automatically render to HTML or PDF.

And, since reST is just a lightly marked-up text file, when I send the PDF to someone I attach that reST document as well. So it's even more easily visible in the email client, and to keyword scrapers.

The #reStructuredText reader is unusual in that it switches behavior when #pandoc is called with `-s` or `--standalone`: In that case, definitions at the start of the document get treated as #metadata.

:title: My Document
:author: Jane Doe
:date: 2023-01-05

Without `--standalone`, that data is treated as part of the main document and parsed as a definition list.

@tommerty I like to use Pelican (because #reStructuredText is the best)

https://getpelican.com/