feat(docs): switch docs to zensical (#125)

This commit is contained in:
banteg
2026-01-13 21:09:27 +04:00
committed by GitHub
parent f9757679c2
commit e671da0a0f
11 changed files with 259 additions and 466 deletions
+27 -13
View File
@@ -6,29 +6,48 @@ Takopi lets you run an engine CLI in a local repo while controlling it from Tele
## Choose your path
- **Im new / I want to get it running**
- Start with **[Tutorials](tutorials/index.md)**:
<div class="grid cards" markdown>
- :lucide-sparkles:{ .lg } **Im new / I want to get it running**
---
Start with [Tutorials](tutorials/index.md).
- [Install & onboard](tutorials/install-and-onboard.md)
- [First run](tutorials/first-run.md)
- **I know what I want to do (enable a feature / fix a workflow)**
- Use **[How-to guides](how-to/index.md)**:
- :lucide-compass:{ .lg } **I know what I want to do**
---
Use [How-to guides](how-to/index.md).
- [Projects](how-to/projects.md) and [Worktrees](how-to/worktrees.md)
- [Topics](how-to/topics.md) and [Route by chat](how-to/route-by-chat.md)
- [File transfer](how-to/file-transfer.md) and [Voice notes](how-to/voice-notes.md)
- **I need exact knobs, defaults, and contracts**
- Go straight to **[Reference](reference/index.md)**:
- :lucide-book:{ .lg } **I need exact knobs, defaults, and contracts**
---
Go straight to [Reference](reference/index.md).
- [Commands & directives](reference/commands-and-directives.md)
- [Configuration](reference/config.md)
- [Specification](reference/specification.md) (normative behavior)
- **Im trying to understand the design**
- Read **[Explanation](explanation/index.md)**:
- :lucide-lightbulb:{ .lg } **I'm trying to understand the design**
---
Read [Explanation](explanation/index.md).
- [Architecture](explanation/architecture.md)
- [Routing & sessions](explanation/routing-and-sessions.md)
- [Plugin system](explanation/plugin-system.md)
</div>
## Quick start
If you just want to see it work end-to-end:
@@ -75,11 +94,6 @@ If youre contributing to core:
## For LLM agents
Takopi publishes an LLM-oriented index at:
* `/llms.txt` — curated entrypoints + links to Markdown mirrors
* `/llms-full.txt` — expanded “single file” context of the most important pages
In the docs, start here:
* [Reference: For agents](reference/agents/index.md)
-59
View File
@@ -1,59 +0,0 @@
/* Takopi palette */
:root {
--takopi-pink: #f4a5b8;
--takopi-flower: #e87a9f;
--takopi-teal: #4a9b8e;
--takopi-teal-bright: #5ab5a6;
}
:root[data-md-color-scheme="default"] {
--md-primary-fg-color: var(--takopi-flower);
--md-primary-fg-color--light: var(--takopi-pink);
--md-primary-fg-color--dark: #d95f86;
--md-accent-fg-color: var(--takopi-teal);
--md-accent-fg-color--transparent: rgba(74, 155, 142, 0.12);
--md-typeset-a-color: var(--takopi-teal);
--md-default-bg-color: #fffaf7;
--md-code-bg-color: rgba(244, 165, 184, 0.1);
}
:root[data-md-color-scheme="slate"] {
--md-primary-fg-color: var(--takopi-pink);
--md-primary-fg-color--light: #f7b9c8;
--md-primary-fg-color--dark: var(--takopi-flower);
--md-accent-fg-color: var(--takopi-teal-bright);
--md-accent-fg-color--transparent: rgba(90, 181, 166, 0.12);
--md-typeset-a-color: var(--takopi-teal-bright);
--md-code-bg-color: rgba(244, 165, 184, 0.12);
}
/* Warm bokeh-ish background */
:root[data-md-color-scheme="default"] body {
background:
radial-gradient(1100px circle at 12% 6%, rgba(244, 165, 184, 0.3), transparent 55%),
radial-gradient(900px circle at 88% 0%, rgba(74, 155, 142, 0.22), transparent 55%),
radial-gradient(1000px circle at 45% 95%, rgba(255, 230, 199, 0.55), transparent 60%),
var(--md-default-bg-color);
}
:root[data-md-color-scheme="slate"] body {
background:
radial-gradient(900px circle at 12% 0%, rgba(244, 165, 184, 0.12), transparent 55%),
radial-gradient(900px circle at 85% 0%, rgba(90, 181, 166, 0.1), transparent 55%),
radial-gradient(1000px circle at 50% 100%, rgba(255, 230, 199, 0.06), transparent 60%),
var(--md-default-bg-color);
}
/* Softer shapes */
.md-typeset .admonition,
.md-typeset details {
border-radius: 12px;
}
.md-typeset .md-button {
border-radius: 999px;
}
::selection {
background: rgba(232, 122, 159, 0.35);
}