| Time |
Nick |
Message |
| 00:41 |
MTDiscord |
<benrob0329> 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 |
<benrob0329> 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 |
<wsor4035> and what exactly would it be useful for? |
| 00:46 |
MTDiscord |
<benrob0329> 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 |
<benrob0329> 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 |
<greenxenith> 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 |
<wsor4035> at the end of the day, markdown |
| 02:12 |
MTDiscord |
<wsor4035> cross section of usable, marketshare, tooling, etc |
| 02:12 |
MTDiscord |
<jordan4ibanez> markup |
| 02:13 |
MTDiscord |
<jordan4ibanez> What even is this channel? |
| 02:13 |
MTDiscord |
<wsor4035> for github.com/minetest/minetest_docs |
| 02:13 |
MTDiscord |
<jordan4ibanez> hm, like the api.md files and whatnot? |
| 02:15 |
MTDiscord |
<greenxenith> Yeah, I want md with macros |
| 02:15 |
MTDiscord |
<jordan4ibanez> that sounds nice |
| 02:15 |
MTDiscord |
<greenxenith> And consistent style checking |
| 02:15 |
MTDiscord |
<jordan4ibanez> Have you guys thought of the inverse pyramid technique? |
| 02:15 |
MTDiscord |
<greenxenith> (Also need machine readability) |
| 02:16 |
MTDiscord |
<wsor4035> should just convert the repo to markdown and call it a day |
| 02:17 |
MTDiscord |
<greenxenith> If it weren't for the annoying amount of js tooling I have to write, MarkDoc seems pretty nice |
| 02:18 |
MTDiscord |
<jordan4ibanez> you know what I'm gonna say |
| 02:18 |
MTDiscord |
<greenxenith> (MarkDoc is what Stripe uses, and it wasn't public/foss when we started the project) |
| 02:18 |
MTDiscord |
<jordan4ibanez> https://tenor.com/view/typescript-script-type-heart-beloved-gif-27005865 |
| 02:18 |
MTDiscord |
<wsor4035> something nonsensical, rewrite in whatever your currently using, etc? |
| 02:19 |
MTDiscord |
<wsor4035> from glancing at the front page, looks like astro |
| 02:21 |
MTDiscord |
<greenxenith> Cool, ill look into that too |
| 02:23 |
MTDiscord |
<wsor4035> https://docs.astro.build/en/guides/markdown-content/ |
| 02:29 |
MTDiscord |
<exe_virus> 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 |
<jordan4ibanez> is there a deno module for what you're doing on the jsr? |
| 03:01 |
MTDiscord |
<benrob0329> GPP (lined above) lets you add macros to anything |
| 03:01 |
MTDiscord |
<benrob0329> *linked |
| 03:04 |
MTDiscord |
<exe_virus> 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 |
<exe_virus> Barring that, at least I have a better starting point now |
| 03:05 |
MTDiscord |
<benrob0329> It's not the only tool for this, but it's got configurable syntax |
| 03:05 |
MTDiscord |
<benrob0329> It's a decently niche use case, surprisingly |
| 03:06 |
MTDiscord |
<exe_virus> 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 |
<benrob0329> (For reference, here's the manual: https://files.nothingisreal.com/software/gpp/gpp.html) |
| 03:09 |
MTDiscord |
<benrob0329> It's got built-in modes for HTML-like, LaTeX-like, C-like, and the base C-ish syntax |
| 03:10 |
MTDiscord |
<benrob0329> 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 |
<jordan4ibanez> how will we ever run these docs in emacs ~some random person that creats a 100 message thread on github |
| 03:39 |
MTDiscord |
<jordan4ibanez> ~creates~ |
| 04:00 |
|
MTDiscord joined #minetest-docs |
