datascape/README.md

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.