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

Back then:
“HTML & CSS? Unsexy, oldschool!!”
throws WordPress/Drupal/Typo3 at a 5-page website

Same people today:
“Headless Markdown, JAMstack, content-first.”

Guess why.
LLMs can only output static content.

#webdev #jamstack #markdown #headless #cms #llms #staticweb #techhumor

Ra mắt OpenSEO Studio: công cụ tạo bài viết SEO tĩnh, mã nguồn mở. Chạy hoàn toàn trên trình duyệt, không backend, không theo dõi, BYOK (khóa API của bạn) không rời trình duyệt. Đảm bảo riêng tư & kiểm soát nội dung tối đa. Đầu ra Markdown.

#OpenSEOStudio #SEO #StaticWeb #SelfHosted #Privacy #AIWriting #MãNguồnMở #QuyềnRiêngTư

https://www.reddit.com/r/selfhosted/comments/1peum4n/i_built_a_100_static_byok_seo_article_generator/

Wrote a review of #StaticQuest now that it's been a little over a year! I had this small goal of a webring with some of the people I follow as just something fun. I didn't know that within that first year I'd have 40 other members enjoy this as well.

https://claytonerrington.com/blog/static-quest/

#staticweb #staticwebsite #100DaysToOffload

Can anyone point me to literature on static websites in open science/open data? I feel like the advantages are obvious and I'm sure I've read bits here and there, but I'm struggling to find a good reference for a grant application...

#staticweb #smallweb #indieweb #OpenData #OpenScience

Comment créer des sites webs personnalisables avec #Quarto pour permettre la consultation de données déposées sur l'entrepôt #Nakala, tout en minimisant leurs coûts de fabrication et de maintenance par @mnauge et David Chesnet (Université de Poitiers).

👉 https://gitlab.huma-num.fr/mshs-poitiers/plateforme/nakala-quarto-view

Une alternative convaincante, particulièrement quand l'usage d'Omeka S n'est pas pas envisageable.

#OpenAccess #StaticWeb

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