87
you are viewing a single comment's thread
view the rest of the comments
view the rest of the comments
this post was submitted on 06 Sep 2024
87 points (94.8% liked)
Selfhosted
40707 readers
130 users here now
A place to share alternatives to popular online services that can be self-hosted without giving up privacy or locking you into a service you don't control.
Rules:
-
Be civil: we're here to support and learn from one another. Insults won't be tolerated. Flame wars are frowned upon.
-
No spam posting.
-
Posts have to be centered around self-hosting. There are other communities for discussing hardware or home computing. If it's not obvious why your post topic revolves around selfhosting, please include details to make it clear.
-
Don't duplicate the full text of your blog or github here. Just post the link for folks to click.
-
Submission headline should match the article title (don’t cherry-pick information from the title to fit your agenda).
-
No trolling.
Resources:
- selfh.st Newsletter and index of selfhosted software and apps
- awesome-selfhosted software
- awesome-sysadmin resources
- Self-Hosted Podcast from Jupiter Broadcasting
Any issues on the community? Report it using the report flag.
Questions? DM the mods!
founded 2 years ago
MODERATORS
My dream is something that can take a stack of markdown files with relative links and generate a static site from them. This is embarrassingly difficult. Right now I think that the GitHub Pages Ruby Gem is the best way but it has too many assumptions about being in a GitHub repository to work. Vanilla Jekyll is nice but I don't want to deal with a bunch of configs to get the experience I want.
I do this with https://www.sphinx-doc.org/ + a basic Makefile and config file to make it a bit nicer. I will publish my template a bit later and report back.
It would be extremely barebones, but you can do something like this with Pandoc.
I think I looked into this before and it lacked a feature, but I don't remember what it was. I might be getting it mixed up with another tool. There were a lot of tools that almost worked but were focused on making books with ordered pages rather than a tree. I think gitbook was one.
For folks interested in following in my footsteps, eleventy didn't fit because it couldn't convert relative links to markdown files to relative HTML links to the HTML files (out of the box, probably possible with plugins).
This just feels like such an obvious thing there would be a tool for but I can't find one. Even most editors that render Markdown as a preview can do this out of the box.