Replied in thread
Why? What does #Shanthy has which for example #reStructuredText or #AsciiDoc don’t (not mentioning some dialect of #Markdown)?
#restructuredtext
0 posts0 participants0 posts today
RestructuredText is more powerful, and full featured than Markdown. Everyone should be using RestructuredText instead of Markdown for their documents and Static Site Generators.
Replied in thread
#pandoc 3.6 has been released:
• Support for #mdoc as input format
• Improved parsing of #reStructuredText
• #Typst 0.12 support
• Safe handling of `--embed-resources` when combined with `--sandbox`
The default templates for LaTeX, ConTeXt, and Typst have been updated.
GitHubRelease pandoc 3.6 · jgm/pandocClick to expand changelog
Add mdoc as input format (Evan Silberman). This change introduces a reader for mdoc, a roff-derived semantic markup language for manual pages. This reader has been devel...
Thinking about transitioning my #blogging from #nikola to #mkdocs
Nikola is great but I've always felt like writing in Markdown is an also ran use case, as its native lingua franca is my long time nemesis #restructuredtext (Hate hate HATE! :) ).
mkdocs is built from the ground up to be super simple. Give it a pile of Markdown and it'll generate a site. There's a nice plugin for generating a blog:
https://github.com/squidfunk/mkdocs-material/blob/master/docs/setup/setting-up-a-blog.md
GitHubmkdocs-material/docs/setup/setting-up-a-blog.md at master · squidfunk/mkdocs-materialDocumentation that simply works. Contribute to squidfunk/mkdocs-material development by creating an account on GitHub.
Sphinx 8.1.0 has just been released 
Sphinx makes it easy to create intelligent and beautiful documentation. 
See here the changelog 
https://www.sphinx-doc.org/en/master/changes/index.html#release-8-1-0-released-oct-10-2024
Replied in thread
I like #reStructuredText, so this is the best one for me (but it can do #Markdown these days as well).
getpelican.comPelican – A Python Static Site Generator
More from 
Pelican
Replied in thread
@pdcawley #Markdown acknowledges its #Textile, #Setext, #reStructuredText, et al influences but prioritizes human readability more: https://daringfireball.net/projects/markdown/syntax#philosophy
daringfireball.netDaring Fireball: Markdown Syntax Documentation
Replied to pandoc
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.
Replied in thread
@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. 
Are you surprised by those results? It seems that #AsciiDoc and #reStructuredText are (way) less popular than I thought, and that #orgmode is way more popular than I expected.
Of course, we should take those results with a grain of salt, as I assume many of my followers are #Emacs users. 
Continued thread
This large scale conversion from #LaTeX to #reStructuredText was achieved thanks to #PanDoc, plus a sprinkling of ah hoc fixers using sed and Python. https://github.com/jgm/pandoc
GitHubContributors to jgm/pandocUniversal markup converter. Contribute to jgm/pandoc development by creating an account on GitHub.
Years in the execution, the #Biopython Tutorial has just switched from #LaTeX with HTML output via hevea http://biopython.org/DIST/docs/tutorial/Tutorial-1.82.html to #reStructuredText #RST output with #Sphinx https://biopython.org/docs/dev/Tutorial/index.html
Replied in thread
> I'm not aware of any other implementation except docutils.
#pandoc can do (both process and generate) #reStructuredText just fine.
Replied in thread
Except for authoring it. (And yes, I prefer #reStructuredText, because it is more defined and richer).
I hate #RestructuredText like the British hate the French.
It's totally irrational and not based in any kind of sane fact.
But I hate it anyway :)
Today's grievance: I have my editor all kitted out to help me write superlative #Markdown. Spelling check, syntax lighlighting, you name it, I got this!
And then someone throws !@$# RestructuredText at me and I'm making spelling errors like a 6th grade n00b and being reelgated to looking back at a cheat sheet 50 times a minute :)
Continued thread
So it appears I was little naive.
Neither #restructuredtext or #ASCIIDOC have the flexibility I need. Looks like I'm staying with m4 as my content preprocessor :-(.
If only we could embed #Python expressions in #restructuredtext ...
(I have used pweave, but it does not seem to be an active project anymore https://github.com/mpastell/Pweave)
GitHubGitHub - mpastell/Pweave: Pweave is a scientific report generator and a literate programming tool for Python. It can capture the results and plots from data analysis and works well with numpy, scipy and matplotlib.Pweave is a scientific report generator and a literate programming tool for Python. It can capture the results and plots from data analysis and works well with numpy, scipy and matplotlib. - GitHub...
after years of extending #Markdown with m4 macros it occurred to me that I should really move to #restructuredtext
PS For those of you under the age of 40 m4 is a macro processor. I used to auto number markdown headings and include code from files. It's a bit hard core and awkward to use. It won't be hard to say goodbye.
en.wikipedia.orgm4 (computer language) - Wikipedia
Naive question, how do #screenreaders handle formatting in #restructuredText and #markdown files?
In particular, #rst relies on long equal or dash lines so I do hope it's handled as a title rather than two separate lines where they would read a long list of punctuation markers...
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