🇬🇧 English · 🇷🇺 Русский

Read online →

A static, zero-build novel reader for Piligrim — a USS espionage novel set in Nice (1940) and Brittany (1944). HTML · CSS · Vanilla JS. Chapters in a custom Markdown dialect. Works offline.

Registry: chapters/manifest.json.

Requirements: Node.js 18+ (for the local dev server only — the site itself has no build step).

git clone https://github.com/krwg/piligrim.git
cd piligrim
.\serve.ps1

Then open the address from the console (usually http://localhost:8000).

Alternative (cross-platform):

npm run serve
# or with a custom port:
.\serve.ps1 3000

Note: A plain file:// open won't work — the reader fetches chapters via HTTP. Always use the dev server or GitHub Pages.

piligrim/
├── index.html              # Entry point
├── manifest.json           # PWA manifest
├── sw.js                   # Service worker (offline cache)
├── serve.ps1               # Windows launcher → tools/serve.mjs
├── package.json            # npm scripts (serve, convert)
├── .nojekyll               # Disables Jekyll on GitHub Pages
├── .github/workflows/
│   └── pages.yml           # Deploy static site (GitHub Actions)
├── assets/
│   ├── fonts/              # Offline typefaces
│   └── img/                # Chapter illustrations & PWA icons
├── chapters/
│   ├── manifest.json       # Chapter registry (title, era, status)
│   ├── ch01.txt            # Published chapter content
│   ├── ch02.txt
│   └── _TEMPLATE.md        # Chapter format reference
└── tools/
    ├── serve.mjs           # Local static server
    ├── convert-chapter.mjs # Source MD → chapter .txt
    ├── convert-ch02.mjs    # Chapter 2 conversion script
    └── glossary-*.mjs      # Footnote enrichment helpers

See chapters/_TEMPLATE.md.

Metadata — inside a ::chapter:: … ::/chapter:: block (not YAML --- front-matter: Jekyll on GitHub Pages swallows --- blocks):

::chapter::
title: Chapter Title (Translation)
when: Month Year, City
era: 1944 · City
epigraph: |
  Quote text.
epigraph_source: "Source"
::/chapter::

Other blocks:

Under every figure the reader adds automatically: «Изображение сгенерировано Google Gemini».

Edit paths in tools/convert-chapter.mjs, then:

npm run convert

Chapter 2 has a dedicated script:

node tools/convert-ch02.mjs

Output: chapters/ch02.txt + 12 illustrations in assets/img/ch02-*.png:

billet · train · vokzal · taxi · pension · diner · marche · promenade · fontaine · jardin · port · traction

1. Add an entry to chapters/manifest.json (id, title, era, status, file).
2. Place the .txt file in chapters/.
3. Add the file path to the service worker cache list in sw.js (if offline support is needed).

1. Settings → Pages → Build and deployment — source: GitHub Actions, workflow Deploy static site (not Jekyll).
2. Keep an empty .nojekyll in the repo root — prevents Jekyll from processing chapter files.
3. Push to main — workflow .github/workflows/pages.yml deploys the repo as-is (no build step).
4. Live URL: https://krwg.github.io/piligrim/

Code and site engine: GNU GPL v3.

Читать онлайн →

Статическая читалка романа «Пилигрим» — шпионский роман об УСС: Ницца 1940, Бретань 1944. Без сборки: HTML, CSS, JavaScript. Главы в собственном Markdown-формате. Работает офлайн.

Реестр: chapters/manifest.json.

Нужно: Node.js 18+ (только для локального сервера — сам сайт не собирается).

git clone https://github.com/krwg/piligrim.git
cd piligrim
.\serve.ps1

Откройте адрес из консоли (обычно http://localhost:8000).

Альтернатива (Windows / macOS / Linux):

npm run serve
# или другой порт:
.\serve.ps1 3000

Важно: через file:// не откроется — читалка загружает главы по HTTP. Используйте локальный сервер или GitHub Pages.

piligrim/
├── index.html              # Точка входа
├── manifest.json           # Манифест PWA
├── sw.js                   # Service worker (офлайн-кэш)
├── serve.ps1               # Запуск сервера (Windows)
├── package.json            # npm-скрипты (serve, convert)
├── .nojekyll               # Отключает Jekyll на GitHub Pages
├── .github/workflows/
│   └── pages.yml           # Деплой статики (GitHub Actions)
├── assets/
│   ├── fonts/              # Локальные шрифты
│   └── img/                # Иллюстрации и иконки PWA
├── chapters/
│   ├── manifest.json       # Реестр глав
│   ├── ch01.txt            # Опубликованная глава
│   ├── ch02.txt
│   └── _TEMPLATE.md        # Справка по формату
└── tools/
    ├── serve.mjs           # Локальный сервер
    ├── convert-chapter.mjs # Конвертация MD → .txt
    ├── convert-ch02.mjs    # Скрипт для главы 2
    └── glossary-*.mjs      # Обогащение сносок

См. chapters/_TEMPLATE.md.

Метаданные — в блоке ::chapter:: … ::/chapter:: (не YAML ---: Jekyll на GitHub Pages съедает такие блоки):

::chapter::
title: Название главы (Перевод)
when: Месяц год, Город
era: 1944 · Город
epigraph: |
  Текст эпиграфа.
epigraph_source: "Источник"
::/chapter::

Другие блоки:

Под каждой иллюстрацией читалка автоматически добавляет: «Изображение сгенерировано Google Gemini».

Отредактируйте пути в tools/convert-chapter.mjs, затем:

npm run convert

Для главы 2 — отдельный скрипт:

node tools/convert-ch02.mjs

Результат: chapters/ch02.txt + 12 иллюстраций в assets/img/ch02-*.png:

billet · train · vokzal · taxi · pension · diner · marche · promenade · fontaine · jardin · port · traction

1. Запись в chapters/manifest.json (id, title, era, status, file).
2. Файл .txt в chapters/.
3. Путь к файлу в кэше service worker (sw.js) — для офлайн-режима.

1. Settings → Pages → Build and deployment — источник: GitHub Actions, workflow Deploy static site (не Jekyll).
2. В корне обязателен пустой .nojekyll.
3. Push в main — workflow .github/workflows/pages.yml деплоит репозиторий как есть (без сборки).
4. Адрес: https://krwg.github.io/piligrim/

Код и движок сайта: GNU GPL v3.

⬆️ Back to top / Наверх