#AGENTS.md
##What this is
Obsidian vault + Hugo content source for
memex.keinmal.top.
Custom Hugo theme:
lichtung.
Origin: HiraethEcho/blogs. All content is Chinese.
##Branches
| branch | purpose |
|---|---|
memex-dev |
active editing (this checkout) |
memex |
triggers CI sync → pushes to separate hiraethecho/memex repo dev branch |
docs |
docs site |
math |
math notes (planned) |
Work on memex-dev, merge to memex when ready.
##Content structure
| dir | purpose | SearchContent |
CountWords |
RSS |
|---|---|---|---|---|
forest/ |
raw info (clips, excerpts, rudiments, morgue/ideas, weblog) | false | false | false |
glade/ |
refined writing (essays, memos, notes) | default | default | true |
diary/ |
daily logs | default | default | default |
All entries are *.md with YAML frontmatter. Use Hugo-style taxonomies for classification.
##Frontmatter conventions
yaml
---
title: # required
date: YYYY-MM-DD
summary: one-liner
tags: [topic1, topic2] or inline list
categories: one of: slash, critique, guide, intropection, kulturprodukte, braindump, log, plan
topics: [academic, lebensform]
series: [barlec, creator, feminism, feminism-film, mp, stand-up]
genres: [argumentative, narrative, opinion]
draft: true | false
status: idea | alpha | wip | beta
HideInFileTree: true
---Root pages (about, me, now, log, links, archive, indexes) use categories: slash + HideInFileTree: true.
##Taxonomy dimensions
categories— cross-cutting content frame (critique, introspection, kulturprodukte, etc.)topics— primary subject (academic, lebensform)tags— concepts/objects referencedseries— multi-part seriesgenres— rhetorical mode (argumentative, narrative, opinion)
##Key conventions
- Markdown links: absolute format (
[text](/path/to/file)), not[[wikilinks]] - Tabs: 2 spaces (no real tabs). Prettier formats markdown with
proseWrap: preserve. - Obsidian vault:
.obsidian/is gitignored. Vim mode enabled. Strict line breaks. - Drafts: use
draft: true+ optionalstatus: idea | alpha | wipin frontmatter. - No build/test/lint commands — pure content. No Hugo config in this repo (it lives in the separate
blogsrepo). .gitignore: ignores.obsidianandall.base.- GHA workflows:
sync.ymlpushes content to separatehiraethecho/memexrepo.token.yamltriggers onsrc/**changes (inactive here — nosrc/dir). - Password-protected entries: some diary posts use a custom password field; if you see one, leave it alone.
##Writing style
ALL content is in Chinese. Read existing posts under glade/essay/ and glade/memo/ to match tone and voice.