├── .github └── workflows │ ├── codeql-analysis.yml │ ├── deno-deploy.yml │ └── test.yml ├── .gitignore ├── .ter └── config.json ├── .vscode └── settings.json ├── attributes.ts ├── components ├── Article.tsx ├── Body.tsx ├── Footer.tsx ├── Header.tsx ├── IndexGrid.tsx ├── IndexList.tsx ├── IndexLog.tsx └── icons.tsx ├── config.ts ├── constants.ts ├── deno.json ├── deno.lock ├── deps ├── deepmerge.ts ├── feed.ts ├── hljs.ts ├── marked.ts ├── preact.ts ├── slug.ts ├── std.ts ├── twind.ts └── ufo.ts ├── docs ├── example-sites.md ├── gfm.md ├── goals.md ├── img │ ├── img-large.jpg │ └── img-small.jpg ├── index.md ├── todo.md ├── usage │ ├── cli-usage.md │ ├── configuration.md │ ├── content.md │ ├── deploy.md │ └── index.md └── zettelkasten.md ├── entries.ts ├── entries_test.ts ├── feed.ts ├── license ├── main.ts ├── markdown.ts ├── markdown_test.ts ├── pages.ts ├── pages_test.ts ├── readme.md ├── render.tsx ├── serve.ts ├── test └── entries │ ├── .should-skip.md │ ├── 2022-12-12-entry-2.md │ ├── _should-skip.md │ ├── dir │ └── child-entry-1.md │ ├── entry-1.md │ ├── img-small.jpg │ └── not-markdown.txt ├── twind.config.ts └── types.d.ts /.github/workflows/codeql-analysis.yml: -------------------------------------------------------------------------------- 1 | name: "CodeQL" 2 | 3 | on: 4 | push: 5 | branches: [master] 6 | pull_request: 7 | # The branches below must be a subset of the branches above 8 | branches: [master] 9 | schedule: 10 | - cron: "15 0 * * 5" 11 | 12 | jobs: 13 | analyze: 14 | name: Analyze 15 | runs-on: ubuntu-latest 16 | permissions: 17 | actions: read 18 | contents: read 19 | security-events: write 20 | 21 | strategy: 22 | fail-fast: false 23 | matrix: 24 | language: ["typescript"] 25 | 26 | steps: 27 | - name: Checkout repository 28 | uses: actions/checkout@v4 29 | 30 | - name: Initialize CodeQL 31 | uses: github/codeql-action/init@v2 32 | with: 33 | languages: ${{ matrix.language }} 34 | 35 | - name: Autobuild 36 | uses: github/codeql-action/autobuild@v2 37 | 38 | - name: Perform CodeQL Analysis 39 | uses: github/codeql-action/analyze@v2 40 | -------------------------------------------------------------------------------- /.github/workflows/deno-deploy.yml: -------------------------------------------------------------------------------- 1 | name: Deploy to Deno Deploy 2 | 3 | on: 4 | push: 5 | branches: [master] 6 | pull_request: 7 | branches: [master] 8 | 9 | jobs: 10 | deploy: 11 | name: Deploy 12 | runs-on: ubuntu-latest 13 | permissions: 14 | id-token: write 15 | contents: read 16 | 17 | steps: 18 | - name: Clone repository 19 | uses: actions/checkout@v4 20 | 21 | - name: Setup Deno 22 | uses: denoland/setup-deno@v1 23 | with: 24 | deno-version: v1.x 25 | 26 | - name: Build site 27 | run: deno task build 28 | 29 | - name: Deploy to Deno Deploy 30 | uses: denoland/deployctl@v1 31 | with: 32 | project: ter 33 | entrypoint: https://deno.land/std/http/file_server.ts 34 | root: _site 35 | -------------------------------------------------------------------------------- /.github/workflows/test.yml: -------------------------------------------------------------------------------- 1 | name: Run Deno tests 2 | 3 | on: 4 | push: 5 | branches: [master] 6 | pull_request: 7 | branches: [master] 8 | 9 | jobs: 10 | run-tests: 11 | runs-on: ubuntu-latest 12 | steps: 13 | - uses: actions/checkout@v4 14 | - uses: denoland/setup-deno@v1 15 | with: 16 | deno-version: v1.x 17 | - name: Run tests 18 | run: deno task test 19 | -------------------------------------------------------------------------------- /.gitignore: -------------------------------------------------------------------------------- 1 | _site 2 | test-10000 3 | cov_profile 4 | node_modules 5 | -------------------------------------------------------------------------------- /.ter/config.json: -------------------------------------------------------------------------------- 1 | { 2 | "title": "Ter", 3 | "description": "A tiny wiki-style site builder with Zettelkasten flavor", 4 | "url": "https://ter.kkga.me/", 5 | "authorName": "Gadzhi Kharkharov", 6 | "authorEmail": "x@kkga.me", 7 | "authorUrl": "https://kkga.me/", 8 | "head": "", 9 | "codeHighlight": true 10 | } 11 | -------------------------------------------------------------------------------- /.vscode/settings.json: -------------------------------------------------------------------------------- 1 | { 2 | "deno.enable": true, 3 | "deno.lint": true, 4 | "deno.codeLens.test": true, 5 | "editor.defaultFormatter": "denoland.vscode-deno", 6 | "deno.unstable": true, 7 | "[github-actions-workflow]": { 8 | "editor.defaultFormatter": "esbenp.prettier-vscode" 9 | } 10 | } 11 | -------------------------------------------------------------------------------- /attributes.ts: -------------------------------------------------------------------------------- 1 | import { JSONValue } from "./types.d.ts"; 2 | 3 | export const hasKey = (data: JSONValue, keys: string[]): boolean => { 4 | if (data) { 5 | for (const key of Object.keys(data)) { 6 | if (keys.includes(key) && data[key] === true) { 7 | return true; 8 | } 9 | } 10 | } 11 | return false; 12 | }; 13 | 14 | export const getVal = (data: JSONValue, key: string): unknown | undefined => 15 | data[key] ?? undefined; 16 | 17 | export const getBool = (data: JSONValue, key: string): boolean | undefined => 18 | data[key] !== undefined && typeof data[key] === "boolean" 19 | ? (data[key] as boolean) 20 | : undefined; 21 | 22 | export const getTitle = (data: JSONValue): string | undefined => 23 | typeof data.title === "string" ? data.title : undefined; 24 | 25 | export const getDescription = (data: JSONValue): string | undefined => 26 | typeof data.description === "string" ? data.description : undefined; 27 | 28 | export const getDate = (data: JSONValue): Date | undefined => 29 | data.date instanceof Date ? data.date : undefined; 30 | 31 | export const getDateUpdated = (data: JSONValue): Date | undefined => 32 | data.dateUpdated instanceof Date ? data.dateUpdated : undefined; 33 | 34 | export const getTags = (data: JSONValue): string[] | undefined => 35 | Array.isArray(data.tags) ? data.tags.map((t) => t.toString()) : undefined; 36 | -------------------------------------------------------------------------------- /components/Article.tsx: -------------------------------------------------------------------------------- 1 | /** @jsxImportSource npm:preact */ 2 | 3 | import { cx } from "../deps/twind.ts"; 4 | import { Heading, Page } from "../types.d.ts"; 5 | 6 | const Toc = ({ headings }: { headings: Heading[] }) => ( 7 | 17 | ); 18 | 19 | const Metadata = ({ 20 | label, 21 | children, 22 | }: { 23 | label?: string; 24 | children: preact.ComponentChildren; 25 | }) => ( 26 |
27 | {label && {label} } 28 |
{children}
29 |
30 | ); 31 | 32 | interface HeaderProps { 33 | url: URL; 34 | lang: Intl.LocalesArgument; 35 | title?: string; 36 | description?: string; 37 | datePublished?: Date; 38 | dateUpdated?: Date; 39 | tags?: string[]; 40 | compact?: boolean; 41 | } 42 | 43 | const Header = ({ 44 | title, 45 | description, 46 | url, 47 | datePublished, 48 | dateUpdated, 49 | tags, 50 | lang, 51 | compact, 52 | }: HeaderProps) => { 53 | const dateFormat: Intl.DateTimeFormatOptions = { 54 | year: "numeric", 55 | month: "short", 56 | day: "numeric", 57 | }; 58 | 59 | return ( 60 |
65 |

{title}

66 | 67 | {description &&

{description}

} 68 | 69 | {(datePublished || dateUpdated || tags) && ( 70 |
71 | {datePublished && ( 72 | 73 | 74 | 77 | 78 | 79 | )} 80 | {dateUpdated && ( 81 | 82 | 85 | 86 | )} 87 | {tags && ( 88 | 89 |
    90 | {tags.map((tag) => ( 91 |
  • 92 | #{tag} 93 |
    • 94 | ))} 95 |
96 | 97 | )} 98 |
99 | )} 100 |
101 | ); 102 | }; 103 | 104 | interface ArticleProps { 105 | page: Page; 106 | lang: Intl.LocalesArgument; 107 | children?: preact.ComponentChildren; 108 | compact?: boolean; 109 | } 110 | 111 | const Article = ({ page, children, lang, compact }: ArticleProps) => { 112 | const { 113 | showHeader, 114 | url, 115 | title, 116 | description, 117 | datePublished, 118 | dateUpdated, 119 | tags, 120 | headings, 121 | showToc, 122 | html, 123 | } = page; 124 | 125 | return ( 126 |
127 | {showHeader && ( 128 |
138 | )} 139 | 140 | {!compact && showToc && headings?.some((h) => h.level >= 2) && ( 141 | h.level <= 2)} /> 142 | )} 143 | 144 | {html &&
} 145 | 146 | {children} 147 |
148 | ); 149 | }; 150 | 151 | export default Article; 152 | -------------------------------------------------------------------------------- /components/Body.tsx: -------------------------------------------------------------------------------- 1 | /** @jsxImportSource npm:preact */ 2 | 3 | import Article from "./Article.tsx"; 4 | import Footer from "./Footer.tsx"; 5 | import Header from "./Header.tsx"; 6 | import IndexList from "./IndexList.tsx"; 7 | import IndexLog from "./IndexLog.tsx"; 8 | import IndexGrid from "./IndexGrid.tsx"; 9 | 10 | import { Crumb, Page } from "../types.d.ts"; 11 | 12 | interface BodyProps { 13 | page: Page; 14 | crumbs: Crumb[]; 15 | childPages?: Page[]; 16 | backlinkPages?: Page[]; 17 | relatedPages?: Page[]; 18 | pagesByTag?: Record; 19 | author?: { name: string; email: string; url: string }; 20 | lang: Intl.LocalesArgument; 21 | } 22 | 23 | const PageIndex = ({ 24 | pages, 25 | layout, 26 | lang, 27 | }: { 28 | pages: Page[]; 29 | layout: Page["layout"]; 30 | lang: Intl.LocalesArgument; 31 | }) => { 32 | switch (layout) { 33 | case "log": 34 | return ; 35 | case "grid": 36 | return ; 37 | default: 38 | return ( 39 | 40 | ); 41 | } 42 | }; 43 | 44 | const Body = ({ 45 | page, 46 | crumbs, 47 | childPages, 48 | backlinkPages, 49 | relatedPages, 50 | pagesByTag, 51 | author, 52 | lang, 53 | }: BodyProps) => ( 54 | 66 |
67 | 68 |
69 |
70 |
71 | 72 | 118 | 119 |