#staticweb — Public Fediverse posts

Silly question for the static webpage people here…

I want to put together a documentation webpage for a system that a few of us have developed. This isn't API documentation, but rather end-user documentation. Some of it will discuss deployment instructions, but there'll be a lot of diagrams and screenshots. I'll host a copy of it, but it will probably also get shipped with the application.

For source-code documentation, I quite like using Doxygen, since it can integrate well with `graphviz` and `mscgen`. `graphviz` is good for showing state transition diagrams, and `mscgen` is great for displaying how messages are passed between systems.

It's good being able to define the diagram *in the text* and have a diagram generated in its place. Makes things a lot easier to maintain.

Doxygen though doesn't work so well without source code. That's 99% of what it does, parse source code for docstrings and format them.

At work I had a similar situation, my employer had chosen to use Hugo, and I needed `graphviz`, the kludge taken there was to use client-side JavaScript to render the diagram. I'd like to avoid that here.

Is there a static website generator out there that can take a block of text in my markdown, and use `graphviz`/`mscgen` to place a diagram in its place?

#StaticWeb #Graphviz #mscgen

I wish I knew about this when I was giving my #PocketPortal workshops: WobbleWeb / wwwobble, an open-source drag-and-drop visual site editor by @ojack.

https://wwwobble.org/

You can also export the static site to host it on Codeberg or the host of your choice.

#wwwobble #WobbleWeb #CandideFindings #staticsitegenerator #staticwebsite #staticwebgenerator #staticweb #HTML #FOSS #smallweb

Glad that #StaticQuest could be renewed this year! Thanks to all the members of the web ring.

https://static.quest

#staticwebsite #staticweb #jekyll #hugo #11ty

2/

"forgejo" comes from the Esperanto word "forĝejo".

"retejo" is (also) an Esperanto word.

The meaning of the Esperanto word "retejo" can be understood as follows:

ret-: The root for "net" or "web".
-ej-: A suffix meaning "place" or "site".
-o: The noun ending.

https://codeberg.org/reiver/retejo

RE: https://mastodon.social/@reiver/115203527761462559

#ActivityPub #ActivityStreams #codeberg #forgejo #GeminiProtocol #gitea #markdown #retejo #SmallNet #SmallWeb #StaticSite #StaticWeb #StaticWebSite

1/

If you are curious about where the "Retejo" name comes from —

The way the name "retejo" was chosen was inspired by how the name "forgejo" chosen.

...

RE: https://mastodon.social/@reiver/115203527761462559

#ActivityPub #ActivityStreams #codeberg #forgejo #GeminiProtocol #gitea #markdown #retejo #SmallNet #SmallWeb #StaticSite #StaticWeb #StaticWebSite

4/

So, I thought — what if I just ran my own web-server to server files from Codeberg.

And thus, Retejo was born.

https://codeberg.org/reiver/retejo

...

But, while I am at it, I can also add automatic ActivityPub / ActivityStreams support to it.

RE: https://mastodon.social/@reiver/115203482817088160

#ActivityPub #ActivityStreams #codeberg #forgejo #GeminiProtocol #gitea #markdown #retejo #SmallNet #SmallWeb #StaticSite #StaticWeb #StaticWebSite

3/

№1:

The software powering Codeberg Pages seems like it isn't being maintained anymore beyond minor fixes

№2:

Although Codeberg is pretty reliable, Codeberg Pages doesn't that reliable.

...

So, I thought —

...

RE: https://mastodon.social/@reiver/115203482817088160

#ActivityPub #ActivityStreams #codeberg #forgejo #GeminiProtocol #gitea #markdown #retejo #SmallNet #SmallWeb #StaticSite #StaticWeb #StaticWebSite

2/

Although I've had a Codeberg account for a number of years — I recently started the process of migrating over to Codeberg (from GitHub).

Codeberg has something similar to GitHub Pages — called Codeberg Pages

https://codeberg.page/

However —

...

RE: https://mastodon.social/@reiver/115203482817088160

#ActivityPub #ActivityStreams #codeberg #forgejo #GeminiProtocol #gitea #markdown #retejo #SmallNet #SmallWeb #StaticSite #StaticWeb #StaticWebSite

1/

Probably the biggest thing that motivated me to create Retejo now (as I've had the idea for this for a number of year) is —

...

RE: https://mastodon.social/@reiver/115203482817088160

#ActivityPub #ActivityStreams #codeberg #forgejo #GeminiProtocol #gitea #markdown #retejo #SmallNet #SmallWeb #StaticSite #StaticWeb #StaticWebSite

2/

Retejo pulls its data from a Forgejo / Gitea site — such as Codeberg.

That means I can write things using whatever text-editor I want by editing a file.

And then push that file to Codeberg — or any other Forgejo / Gitea site — using git

And then, it automatically shows up on my Retejo site

https://codeberg.org/reiver/retejo

RE: https://mastodon.social/@reiver/115203416378004810

#ActivityPub #ActivityStreams #codeberg #forgejo #GeminiProtocol #gitea #markdown #retejo #SmallNet #SmallWeb #StaticSite #StaticWeb #StaticWebSite

1/

Another motivation for creating Retejo is this:

https://mastodon.social/@reiver/114076598430655105

I want to be able to write long-form articles using whatever text-editor I choose to use, editing a file, and using git.

Not everyone will want to create long-form content this way — but I want to create long-form content this way.

...

RE: https://mastodon.social/@reiver/115203416378004810

#ActivityPub #ActivityStreams #codeberg #forgejo #GeminiProtocol #gitea #markdown #retejo #SmallNet #SmallWeb #StaticSite #StaticWeb #StaticWebSite

3/

I kept that type of user in mind when designing Retejo —

That some people want to write in Markdown rather than HTML.

So, Retejo has native support for Markdown.

And, in particular, CommonMark with the GitHub Flavored Markdown (GTM) extensions that most people expect nowadays.

https://codeberg.org/reiver/retejo

.

RE: https://mastodon.social/@reiver/115203390761929242

#ActivityPub #ActivityStreams #codeberg #forgejo #GeminiProtocol #gitea #markdown #retejo #SmallNet #SmallWeb #StaticSite #StaticWeb #StaticWebSite

2/

One thing I noticed about the Gemini-Protocol community is that —

Some of the people who are attracted to Gemini are attracted to it, because — they want a Web that was based on Markdown instead of HTML.

And, the Gemini-Protocol + gemtext seemed close to being a Markdown-based Web.

https://mastodon.social/@reiver/111180217090707425

...

RE: https://mastodon.social/@reiver/115203390761929242

#ActivityPub #ActivityStreams #codeberg #forgejo #GeminiProtocol #gitea #markdown #retejo #SmallNet #SmallWeb #StaticSite #StaticWeb #StaticWebSite

1/

One of my other passions, in addition to the Fediverse and Social Web, is — small-net.

One of the popular protocols in small-net is — the Gemini-Protocol.

https://geminiprotocol.net/

...

RE: https://mastodon.social/@reiver/115203390761929242

#ActivityPub #ActivityStreams #codeberg #forgejo #GeminiProtocol #gitea #markdown #retejo #SmallNet #SmallWeb #StaticSite #StaticWeb #StaticWebSite

So I've decided to join the 90's and do a blog. I have a domain, looking for a host. Cheaper = better, up to a point. Any ideas?

Must haves:

(1) Markdown support
(2) Math typesetting
(3) Good tagging
(4) RSS support (multiple RSS feeds by tag preferred)

I've tried static sites and I've not gotten very far.

I'm open to static - that IS probably best for my needs - but DIY static hasn't worked.

Boosts for visibility appreciated.

#websites #math #mathjax #markdown #blog #blogs #staticweb