mirror of https://github.com/agentscope-ai/ReMe.git synced 2026-09-30 01:52:29 +00:00

History

jinliyl 8b5456641f Some checks failed CI / Python quality / GitHub Actions (push) Waiting to run Details CI / Python quality / Pre-commit (push) Waiting to run Details CI / Python tests / Unit Tests - py3.11 (push) Waiting to run Details CI / Python tests / Unit Tests - py3.12 (push) Waiting to run Details CI / Python tests / Unit Tests - py3.13 (push) Waiting to run Details CI / Python tests / Unit Tests - py3.14 (push) Waiting to run Details CI / Windows / CLI smoke - py3.11 (push) Waiting to run Details Security / CodeQL / Analyze javascript-typescript (push) Waiting to run Details Security / CodeQL / Analyze python (push) Waiting to run Details Deploy / Documentation / Build documentation (push) Has been cancelled Details Deploy / Documentation / deploy (push) Has been cancelled Details docs: show ReMe ecosystem on homepage (#568 ) * docs: show ReMe ecosystem on homepage * fix(docs): prevent hero title from overlapping ecosystem column At 1366x768 the English headline used white-space: pre inside a left column squeezed to ~538px by the 650px right column, so it overflowed onto the ecosystem map (review comment on #568). - use white-space: pre-wrap so the headline wraps within its column - stack the hero to a single column below 1680px (benchmark/traffic sections keep their original 1320px breakpoint) - pin the ecosystem column to 650px and cap the headline at 76px so the two-line headline fits beside it at 1681px and wider Co-Authored-By: Claude Code <noreply@anthropic.com> --------- Co-authored-by: Claude Code <noreply@anthropic.com>		2026-09-24 11:58:05 +08:00
..
public	docs: show ReMe ecosystem on homepage (#568 )	2026-09-24 11:58:05 +08:00
scripts	docs: show ReMe ecosystem on homepage (#568 )	2026-09-24 11:58:05 +08:00
tests	docs: show ReMe ecosystem on homepage (#568 )	2026-09-24 11:58:05 +08:00
.gitignore	docs: add standalone GitHub Pages site (#448 )	2026-08-12 11:55:35 +08:00
ecosystem-assets.md	docs: show ReMe ecosystem on homepage (#568 )	2026-09-24 11:58:05 +08:00
package-lock.json	docs: rebuild documentation site with VitePress (#518 )	2026-09-04 14:50:50 +08:00
package.json	docs: rebuild documentation site with VitePress (#518 )	2026-09-04 14:50:50 +08:00
README.md	refactor(integrations): split TypeScript host plugins (#536 )	2026-09-11 13:06:02 +08:00

README.md

ReMe documentation site

This package builds the VitePress site published at https://reme.agentscope.io. The canonical documentation lives in docs/; selected product, integration, plugin, and benchmark READMEs are mirrored into a disposable source tree during the build. Do not edit .generated/ or dist/.

Requirements

Node.js 22.13 or newer
npm

Local development

cd github-pages
npm ci
npm run dev

The development server prints its local URL. Restart it after changing a mirrored README or reme/config/default.yaml so the generated source tree and Job reference are refreshed. Changes under docs/ are also refreshed on restart.

Validation

npm test
npm run build
npm run preview

The test suite verifies bilingual core pages, canonical-source mappings, generated Job coverage, and disposable output. The production build is written to github-pages/dist/ for the existing GitHub Pages workflow.

Sources

docs/: canonical guides, VitePress configuration, theme, and brand assets
reme/config/default.yaml: generated callable Job reference
reme_studio/README*.md: ReMe Studio
integrations/{dsh,openclaw}/README*.md: TypeScript host plugins
plugins/*/README*.md: plugin guides
benchmark/*/README*.md: benchmark guides
scripts/generate-content.mjs: source mirroring and reference generation

When adding a canonical guide, add both docs/zh/<name>.md and docs/en/<name>.md, then include it in the appropriate sidebar in docs/.vitepress/config.mts. Add repository-owned READMEs to externalDocuments in the generator rather than duplicating their full content under docs/.

Deployment

.github/workflows/deploy-docs.yml uses the reusable documentation build workflow and publishes dist/ to GitHub Pages. public/CNAME preserves the reme.agentscope.io custom domain.