datascape
Minimal self-hosted personal wiki. Folders are pages.
Run
go run . -dir ./wiki -addr :8080
go run . -dir ./wiki -addr :8080 -user me -pass secret
Build
# local
go build -o datascape .
# QNAP NAS (linux/arm)
GOOS=linux GOARCH=arm go build -o datascape .
Usage
| Action | How |
|---|---|
| Browse | Navigate folders at / |
| Read | Any folder with index.md renders it as HTML |
| Edit | Append ?edit to any folder URL, or click [EDIT] (Alt+Shift+E) |
| Save | POST from the edit form writes index.md to disk; folder is created if needed |
| New page | Click [NEW] (Alt+Shift+N), enter a name — opens the new page in edit mode |
| Files | Drop PDFs, images, etc. next to index.md — they appear in the listing |
Navigating to a URL that does not exist shows an empty page with a [CREATE] prompt.
Special Folder Types
A folder can opt into special rendering by adding a .page-settings file:
type = diary
Diary
Designed for a chronological photo diary. Expected structure:
FolderName/
.page-settings ← type = diary
YYYY/
YYYY-MM-DD Desc.jpg ← photos named with date prefix
MM/
DD/
index.md ← diary entry for that day
| View | What renders |
|---|---|
Year (YYYY/) |
Section per month with link and photo count |
Month (MM/) |
Section per day with entry content and photo grid |
Day (DD/) |
Entry content and photo grid |
Days with photos but no index.md still appear in the month view and can be created by clicking their heading link.
Description
Languages
JavaScript
40.9%
Go
35%
CSS
12.4%
HTML
11%
Makefile
0.7%