docs: single English site at the root; theme manual-home components - #29
Merged
Conversation
Homepage is an index only — remove paper figure dump and molpack-specific system-flow/result CSS. Align EN/ZH home, quickstart, and Python index with molcrafts-zensical-theme manual components; leave extra.css minimal.
Restructure per Zensical alternate + molexp pattern so Chinese never falls out of /zh/. English sources live in docs/en (zensical.toml → site/en); Chinese parallel tree in docs/zh (zensical.zh.toml → site/zh) with shared assets via symlink. Update rustdoc include paths and dual-build notes.
Per https://zensical.org/docs/setup/language/ — one theme.language per project, dual builds for en/zh, and extra.alternate with absolute links. Set per-language site_url (…/en/, …/zh/) and full alternate URLs so the GitHub Pages /molpack/ prefix is not dropped.
Match https://zensical.org/docs/setup/language/ exactly: single project config, theme.language = en, extra.alternate links /en/ and /zh/. Content under docs/en and docs/zh; one `zensical build` publishes both trees. Remove zensical.zh.toml.
Drop the Chinese tree (docs/zh) and the `alternate` language selector, and move docs/en back to docs/ so the site is served from the root — which also removes the reason the root-redirect.html hack existed. Follow the doc-include paths in src/lib.rs, the restraint module comment, README, and CONTRIBUTING to the flattened layout.
`smoke_pack_pbc_only_finishes_quickly` asserted `elapsed < 30 s` on a subprocess run — a nondeterministic gate on a loaded runner. The hang it guards against (2000 A cell grid, ~10^8 cells) still fails the test by never completing, so the regression stays covered without the timing assert. Renamed to `smoke_pack_pbc_only_completes`.
`tests/cli.rs` dropped `smoke_pack_mixture` and `smoke_pack_pbc_only_completes` along with the "smoke tests" section; the CLI file keeps its argument- and error-path assertions. `python/tests/test_examples_smoke.py` is gone entirely — it only ast-parsed the example scripts and checked their PDB fixtures loaded. Packing behaviour stays covered by the Packmol regression suite (`tests/examples_batch.rs`, `--ignored`).
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Docs site
docs/en/moves back todocs/,docs/zh/and thealternatelanguage selector are gone, and so isdocs/root-redirect.html— with English at/there is nothing to redirectzensical.tomlisdocs_dir = "docs"/site_dir = "site",site_url = https://molpack.molcrafts.org/Follow-through on the flattened layout: the four
include_str!("../docs/*.md")doc chapters insrc/lib.rs, thesrc/restraint/mod.rscomment, README, and CONTRIBUTING.Test
smoke_pack_pbc_only_finishes_quicklyassertedelapsed < 30 son a subprocess run — a nondeterministic gate on a loaded runner. The hang it guards (2000 A cell grid, ~10^8 cells) still fails the test by never completing, so the regression stays covered. Renamedsmoke_pack_pbc_only_completes.Verification
zensical build --strictclean;site/index.htmlat the root,/install/,/python/,/rust/all presentcargo checkgreen (doc-include paths),cargo test --features cli --test cli— 7 passed