Time Nick Message 00:41 MTDiscord Oh hey, I have found and used a tool that would help with some of the gripes with this project: https://github.com/logological/gpp/ 00:43 MTDiscord It's a generic text preprocessor that I've been using for HTML to assist me with writing documents using Weasyprint (as opposed to LaTeX, which I had been using for it's macro support), but it'd work with AsciiDoc or Markdown just the same. It has customisable syntax and is packaged by most major distros 00:43 MTDiscord and what exactly would it be useful for? 00:46 MTDiscord Macros, one of the big gripes was how repetitive some of the syntax was when many things were shoved into tables or other bits of formatting that shoudn't need to be repeated every time 00:47 MTDiscord Maybe it's not as big an issue as I remember, but it's helped me so I figured I'd share it 02:11 MTDiscord I've actually been testing alternative doc formats than asciidoc, since adoc has a number of disadvantages more visible after using it 02:12 MTDiscord at the end of the day, markdown 02:12 MTDiscord cross section of usable, marketshare, tooling, etc 02:12 MTDiscord markup 02:13 MTDiscord What even is this channel? 02:13 MTDiscord for github.com/minetest/minetest_docs 02:13 MTDiscord hm, like the api.md files and whatnot? 02:15 MTDiscord Yeah, I want md with macros 02:15 MTDiscord that sounds nice 02:15 MTDiscord And consistent style checking 02:15 MTDiscord Have you guys thought of the inverse pyramid technique? 02:15 MTDiscord (Also need machine readability) 02:16 MTDiscord should just convert the repo to markdown and call it a day 02:17 MTDiscord If it weren't for the annoying amount of js tooling I have to write, MarkDoc seems pretty nice 02:18 MTDiscord you know what I'm gonna say 02:18 MTDiscord (MarkDoc is what Stripe uses, and it wasn't public/foss when we started the project) 02:18 MTDiscord https://tenor.com/view/typescript-script-type-heart-beloved-gif-27005865 02:18 MTDiscord something nonsensical, rewrite in whatever your currently using, etc? 02:19 MTDiscord from glancing at the front page, looks like astro 02:21 MTDiscord Cool, ill look into that too 02:23 MTDiscord https://docs.astro.build/en/guides/markdown-content/ 02:29 MTDiscord Markdown with macros. I keep coming back to the idea that all clean languages need a common meta language to macro them cleanly. The C preprocessor is the worst version of whatever this language would be. Php is a close second. That's about all I got so far. 02:32 MTDiscord is there a deno module for what you're doing on the jsr? 03:01 MTDiscord GPP (lined above) lets you add macros to anything 03:01 MTDiscord *linked 03:04 MTDiscord Hurm, yuk. Mediocre syntax, though not horrible. Not cross platform. Looks like there's no good tooling with vscodium where I can view with the macro language, and toggle to the expanded output. 03:05 MTDiscord Barring that, at least I have a better starting point now 03:05 MTDiscord It's not the only tool for this, but it's got configurable syntax 03:05 MTDiscord It's a decently niche use case, surprisingly 03:06 MTDiscord Configurable is good, because inevitably you run against a language that doesn't play with your syntax. But I would expect it to be as simple as changing the # to a √ 03:09 MTDiscord (For reference, here's the manual: https://files.nothingisreal.com/software/gpp/gpp.html) 03:09 MTDiscord It's got built-in modes for HTML-like, LaTeX-like, C-like, and the base C-ish syntax 03:10 MTDiscord If you find a nicer tool though, I'd love to have some options. I've been messing around with writing stuff with HTML + Weasyprint and havine macros is essential to keeping me sane 03:39 MTDiscord how will we ever run these docs in emacs ~some random person that creats a 100 message thread on github 03:39 MTDiscord ~creates~