Commit 6e823713 authored by Kourser's avatar Kourser
Browse files

Merge: Docusaurus multilingual docs site (24 locales)

parents 80104cd5 39d0af68
Loading
Loading
Loading
Loading
+34 −10
Changes for .gitlab-ci.yml: 34 added lines, 10 removed lines.
Original line number Diff line number Diff line
# Runner: shell executor (amd64/linux), system python3 without the
# `python3-venv` package (no ensurepip). We create a venv WITHOUT pip (which
# skips ensurepip), then bootstrap pip into it via get-pip.py. This needs only
# `python3` and network access to PyPI + bootstrap.pypa.io — no apt/sudo.
# GitLab Pages — Docusaurus multilingual site (see website/).
# Docker executor with a PINNED Node image (org policy: no floating versions —
# do not use node:latest). The site lives in website/; the build output
# (website/build) is moved to public/ at the repo root for Pages.

image: node:20.20.2

stages:
  - test
  - deploy

# Cache node_modules across pipelines, keyed by the lockfile.
default:
  cache:
    key:
      files:
        - website/package-lock.json
    paths:
      - website/node_modules/

# Build check on branches / merge requests (does not publish).
build:
  stage: test
  script:
    - cd website
    - npm ci
    - npx docusaurus clear    # drop stale .docusaurus / node_modules/.cache (cached across pipelines)
    - npm run build
  rules:
    - if: '$CI_COMMIT_BRANCH != $CI_DEFAULT_BRANCH'
    - if: '$CI_PIPELINE_SOURCE == "merge_request_event"'

# Publish from the default branch, matching the previous MkDocs deploy.
pages:
  stage: deploy
  script:
    - python3 -m venv --without-pip .venv
    - . .venv/bin/activate
    - python -c "import urllib.request; urllib.request.urlretrieve('https://bootstrap.pypa.io/get-pip.py', 'get-pip.py')"
    - python get-pip.py
    - pip install mkdocs==1.6.1 mkdocs-material==9.6.9
    - mkdocs build --site-dir public
    - cd website
    - npm ci
    - npx docusaurus clear     # drop stale .docusaurus / node_modules/.cache (cached across pipelines)
    - npm run build            # runs `prebuild` → sync localized screenshots + mirror fallback docs
    - mv build ../public
  artifacts:
    paths:
      - public
+7 −5
Changes for README.md: 7 added lines, 5 removed lines.
Original line number Diff line number Diff line
@@ -100,14 +100,16 @@ par-dessus :
| `DiscoveryKit` | Recherche iTunes + fyyd + Radio Browser, import OPML |
| `SyncKit` | Sync Nextcloud / gpodder.net |

Détails : [docs/Architecture.md](docs/Architecture.md).
Détails : [Architecture](https://kourser.pages.git.cythin.eu/skingomz-app/architecture).

## Documentation

- 📖 [Guide utilisateur](docs/Guide-utilisateur.md)
- 🔄 [Configurer la synchronisation](docs/Synchronisation.md)
- 🏗️ [Architecture](docs/Architecture.md) · [Développement](docs/Developpement.md)
- ❓ [FAQ](docs/FAQ.md)
Le site de documentation est disponible en **24 langues** : <https://kourser.pages.git.cythin.eu/skingomz-app/>

- 📖 [Guide utilisateur](https://kourser.pages.git.cythin.eu/skingomz-app/guide)
- 🔄 [Configurer la synchronisation](https://kourser.pages.git.cythin.eu/skingomz-app/synchronisation)
- 🏗️ [Architecture](https://kourser.pages.git.cythin.eu/skingomz-app/architecture) · [Développement](https://kourser.pages.git.cythin.eu/skingomz-app/developpement)
- ❓ [FAQ](https://kourser.pages.git.cythin.eu/skingomz-app/faq)
- 🗺️ [Feuille de route](ROADMAP.md)

## Contribuer
−18

File deleted.

−40

File deleted.

+28
Changes for website/.gitignore: 28 added lines, 0 removed lines.
Original line number Diff line number Diff line
# Dependencies
/node_modules

# Production build
/build

# Generated
/.docusaurus
/.cache-loader

# Generated by scripts/sync-i18n-assets.mjs (prebuild):
# Localized screenshots (relative _shots folders next to the docs).
/docs/_shots
/i18n/*/docusaurus-plugin-content-docs/current/_shots
# French contributor-doc fallbacks mirrored into locales — except the real
# English translations, which ARE committed.
/i18n/*/docusaurus-plugin-content-docs/current/architecture.md
/i18n/*/docusaurus-plugin-content-docs/current/developpement.md
!/i18n/en/docusaurus-plugin-content-docs/current/architecture.md
!/i18n/en/docusaurus-plugin-content-docs/current/developpement.md

# appcast.json is mirrored from ../docs/appcast.json by the prebuild (source of
# truth stays docs/appcast.json, updated by the release process).
/static/appcast.json

# Misc
.DS_Store
npm-debug.log*
Loading