Selfhosted

62398 readers

500 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:

Detailed Rules Post

Be civil.
No spam.
Posts are to be related to self-hosting.
Don't duplicate the full text of your blog or readme if you're providing a link.
Submission headline should match the article title.
No trolling.
Promotion posts require active participation, with an account that is at least 30 days old. F/LOSS without a paywall has exceptions, with requirements. See the rules link for details. Tags [CBH] or [AIP] are required, see the links in Rule 8 for details.
AI-related discussions and AI-involved promotional posts have additional requirements for tagging, as noted in Rule 7 and the AI & Promotional Post Expanded Rules post, and find example disclosures here.

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 3 years ago

MODERATORS

curbstickle@anarchist.nexus

curbstickle_lw@lemmy.world

Wikidocs (for storing your home-lab structure) (github.com)

submitted 5 days ago by SuspiciousCarrot78@aussie.zone to c/selfhosted@lemmy.world

20 comments fedilink hide all child comments

Probably old hat to some...but documentation is important. Just for once...I am trying to keep documentation AHEAD of the inevitable bork that destroys everything... so that in 3 months time I don't have to reconstitute everything out of thin air and swearing.

Anyhow, I came across this lovely little repo a while ago and though "yes, next time, use this"

https://github.com/Zavy86/WikiDocs

And so I am :)

I'll let the author speak to the perks (no affiliation, I just like wikidocs and wanted to share it)

Open source
Plain text files
No database required
Markdown syntax
YAML Frontmatter
Editor full WYSIWYG
Support for KaTeX math
Support for Mermaid diagrams
Unlimited page revisions
Uploading and downloading attachments
Uploading images (also from clipboard)
Content can be categorized in namespaces
Public and private browsing
Desktop and remote sync
Syntax highlighting
Multiple languages
Dark mode

While I show off a happy snap

you are viewing a single comment's thread
view the rest of the comments

[–] solrize@lemmy.ml 2 points 5 days ago (2 children)

If no database, how is revision history maintained? Of course while there's nothing wrong with someone deciding to write yet another self-hosted wiki, is there anything special about this one? "apt install gitit" has worked ok for me when I've wanted a low hassle wiki.

[–] SuspiciousCarrot78@aussie.zone 3 points 5 days ago* (last edited 5 days ago) (1 children)

On revisions, I am not actually sure how WikiDocs stores the old versions internally. The project advertises unlimited revisions and rollback despite using flat files rather than a database. So...dunno.

Gitit looks very capable too, especially if you already want Git as the storage and revision layer.

What appealed to me about WikiDocs was less that it had some unique technical trick and more that it packaged the things I wanted into one nice interface: Markdown files, WYSIWYG editing, namespaces, attachments, Mermaid, etc etc

EDIT: "WikiDocs stores revisions as timestamped Markdown snapshots alongside each page".

my-page/
├── content.md
└── versions/
    ├── 1790201234567.md
    ├── 1790287654321.md
    └── 1790374567890.md

[–] flightyhobler@lemmy.world 1 points 4 days ago (1 children)

So I can't just point it to my current .md folder and let it rip.

[–] SuspiciousCarrot78@aussie.zone 1 points 4 days ago* (last edited 4 days ago)

Dunno. Try it, see what happens. Probably nothing good :)

OTOH, if you have a local LLM, you should be able to get it to template your existing .md into a sane wiki structure.

[–] Eldaroth@lemmy.world 1 points 5 days ago

Well I assume this is thought to be used in conjunction with a Git repository (as its all just markdown files). So this would handle revision history for you.