GEO Citation Lab
Use the repository distribution contract to choose the smallest safe delivery mode and report the result in plain language.
Route the request
- For “安装”, “打开”, or “本地阅读”, install the lightweight Viewer.
- For “部署” or “GitHub Pages”, confirm the GitHub target before making external changes.
- For “完整数据” or “分析环境”, state the approximate size and clone the full repository.
- For reading only, open
https://yaojingang.github.io/geo-citation-lab/.
Read deploy/manifest.json from the repository root. If no checkout is available, fetch
https://raw.githubusercontent.com/yaojingang/geo-citation-lab/main/deploy/manifest.json.
Treat the manifest as the source of asset names, versions, size limits, and entrypoints.
Install the Viewer
- Require
release_status: released, then download the version-pinned asset and matching installer. The raw repository copies ofscripts/install.shandscripts/install.ps1are the source fallback. - Inspect the installer before execution.
- Run
scripts/install.shon macOS/Linux orscripts/install.ps1on Windows. - Let the installer download and verify the latest ZIP and SHA-256 sidecar.
- Open the returned
index.htmlunless the user requested download only. - Report
status,install_path,entrypoint, andbackup_pathwhen present.
Never pipe an unreviewed remote script into a shell. Preserve an existing installation unless its
directory contains .geo-citation-lab-install.
If release_status is pending or the pinned Release is unavailable, report that remote
installation is not published. A maintainer inside a checkout may build local assets with
python3 scripts/build_viewer.py --package.
Deploy to GitHub Pages
- Resolve the authenticated GitHub identity and exact target repository.
- Read
deployment.requires_license_complianceandrequired_notice_files. Preserve every required notice file, the requested attribution, and an indication of changes to CC BY 4.0 content. - Confirm the target and public visibility.
- Run
python3 scripts/verify_distribution.py. - Confirm before changing an existing Pages publishing source.
- Use
.github/workflows/publish.ymlto deploy the generated Viewer. - Read the completed workflow state and return its public URL.
Repository creation, visibility changes, Pages source changes, tags, pushes, and releases require explicit user approval.
Download full data
State that the complete working tree is approximately 568 MiB. Clone the repository only after the
user requests full data or analysis. For 03-cn-geo-citation-dataset, follow its README and use
Python 3.11 or newer with uv.
Read LICENSE, LICENSE-CODE, LICENSE-CONTENT, and THIRD_PARTY_NOTICES.md before
redistribution. Code is MIT licensed, original GEO Citation Lab content is CC BY 4.0, and
third-party materials retain their source terms.