Twisted's coding standard for our #ReStructuredText files is to use what we have termed "semantic newlines". That is to say: every sentence is on its own line. In principle, I like this. It means smaller, more readable diffs, and less pointless churn. In practice, with my #Emacs fill-paragraph muscle memory, it is a *constant* frustrating exercise where I'm tripping over myself and either constantly re-wrapping and then manually un-wrapping, or forgetting to wrap at all.
#restructuredtext
1 post1 participant0 posts today
Hawkmoth v0.20 is out!
Hawkmoth is a Sphinx extension to import C and C++ documentation comments into Sphinx based documentation.
The main new feature in this release is automatic configuration of the system header search paths. Unfortunately, libclang does not get them right out of the box on most distros, so we have to help it a little.
GitHubGitHub - jnikula/hawkmoth: Hawkmoth - Sphinx Autodoc for CHawkmoth - Sphinx Autodoc for C. Contribute to jnikula/hawkmoth development by creating an account on GitHub.
Replied in thread
Why? What does #Shanthy has which for example #reStructuredText or #AsciiDoc don’t (not mentioning some dialect of #Markdown)?
RestructuredText is more powerful, and full featured than Markdown. Everyone should be using RestructuredText instead of Markdown for their documents and Static Site Generators.
️ rst2gemtext v0.4.0 released!
rst2gemtext is a CLI tool and a #Python library to convert #reStructuredText to #Gemtext (the markup language used by #Gemini network).
https://github.com/flozz/rst2gemtext/releases/tag/v0.4.0
This release contains mostly fixes on lists of link and tables. Supported Python versions have also been updated. 
️
GitHubRelease rst2gemtext v0.4.0 · flozz/rst2gemtextfeat: Skip topic nodes as the ToC will not be generated (@flozz)
fix: Fixed bad link list deduplication when a non-breaking space is used in anchor text (@flozz)
fix: Fixed troncated tables when mu...
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...
Replied to Bozhidar Batsov (a.k.a. Bug)
@bbatsov Exactly, if you made research on #Python programmers, you would get quite different results (we all use #reStructuredText ).
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. 
Replied in thread
> I'm not aware of any other implementation except docutils.
#pandoc can do (both process and generate) #reStructuredText just fine.
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 :)
Replied in thread
@jkibble I'm talking about... everything that generates HTML markup. The standard #Markdown and #RestructuredText specs say *emphasis* and **strong** instead of italic/bold. Every #WYSIWYG editor I've come across, from #Tumblr #Wordpress #Reddit #tinymce #ckeditor etc., all show you a "B" and "I" button but render <strong>/<em>. Obviously nobody writing text cares about "strong" and "emphasis," they just want italic and bold. I feel like the world has gone insane.
Replied in thread
@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).
Q1: Which one do you regularly use, why?
Q2: Which one was easier to learn for you?
Q3: What are you using it for? (Blogging, eBook, research papers, others)
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
Continued thread
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.
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.
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.