💾 Archived View for bbs.geminispace.org › s › programming › 22174 captured on 2024-12-17 at 15:09:19. Gemini links have been rewritten to link to archived content
-=-=-=-=-=-=-
I've created Artick, which is a static site generator that can export to HTML and Gemtext.
It has its own format that it converts to either (and possibly more in the future) so you don't have to worry about keeping HTTP and Gemini versions of your site in sync.
As well as that, you can assign pages /groups/, and every group is given its own page. This makes site navigation easier, and is my preferred alternative to the hierarchical site structure that seems to be more common.
Currently it doesn't have too many features; right now it's mostly just for writing simple static content. In the future, I might add some more advanced features like macros.
It's written in TypeScript using Deno, and I tried to make it easily hackable. I've documented it in the documentation link below, which itself is written using Artick.
Nov 25 · 3 weeks ago · 👍 jdcard, mrrobinhood5, HanzBrix, jutty
This is pretty cool!
You might want to read this, though:
I agree that you should not use Unicode for styling. In addition to the things mentioned there, you can avoid using Unicode when ASCII would do, and avoid problems with unavailable fonts and other stuff like that.
I would also suggest to omit the CSS output entirely if no colours/fonts have been specified at all (but to use the defaults in the program if some are specified and some are omitted.)
(I had also written a static site generator (in C), although it does not currently support Gemini and HTML (and it isn't something that I intend to add but may accept contributions which may do so if someone finds this useful), but I do have some features that yours doesn't (and vice versa).)
🐑 thezipcreator [OP] · Nov 25 at 23:55:
@satch that's a fair point; I hadn't considered how screenreaders would read it. In config.json I currently have it as an optional feature (that's by default disabled, but I enabled it on my site; when disabled it just uses styling like /italics/ *bold* `code`) but maybe I should just remove it altogether.
🐑 thezipcreator [OP] · Nov 26 at 00:15:
@zzo38 what do you mean omit the CSS if no colors/fonts have been specified? There sort of needs to be CSS given that the default page format has some styling and isn't just bare HTML.
I couldn't find your ssg so I am curious what features are missing from mine, so I know what to work on.
About omit CSS, I mean that it seems that plain HTML would be suitable (looking at it, looks like OK); some people might want to use a static site generator without adding CSS. (Some people who view HTML also like to use it without CSS, and the author also might want to use the user's default settings. Of course that is not always the case, but not everyone likes the CSS even if you use HTML.)
Some features of mine are: character set switching, ability to embed the output from external programs, templates, sequence numbers, command files. (Some features that you have that I don't have (yet) are: footnotes, references.) (Mine is called "asciitoscorp" and is in GitHub. As I had said currently the output formats are also different (which is the reason for the name, actually), but additional output formats may be added later if anyone decides to do so.)
(Some of these might be you consider to be out of scope of what you intend to make; I don't know. Of course there are many static site generators and have different features; they don't all need to have same things and they will be difference than each other. (For example, I think some might also support Gopher.))