Repository navigation
site: port the archived pubid-*/README content — ISO/IEC/PLATEAU ports, 6 missing flavor pages, construction guide - #20
Conversation
… ports, 6 missing flavor pages, construction guide The website was missing six flavors the pubid 2 registry carries (doi, evs, gb, isbn, omg, un) and the usage narrative the archived per-gem READMEs held: the ISO format options, the IEC TRF grammars, and the PLATEAU Handbook #11 edition split. - New publisher pages: doi, evs, gb, isbn, omg, un — built from the monogem's identifier classes and pass fixtures, every example verified by parsing it with the gem (bare ISBN/DOI forms noted as flavor-entry-point parses; ISBN hyphenation preserved as given). `Publisher.logo` becomes optional so a page renders the two-letter badge until a logo asset exists. - ISO page: a Rendering Styles section documents the live rendering options (lang_single, stage_format_long, with_date, with_edition — the v1 `format:`-symbol API is not a v2 API); the amendment/corrigendum docTypes now carry the DAM/FDAM and DCor/FDCor stage rules with verified normalization examples; the Typed Stage component lists the supplement stages. - IEC page: the iecee_trf docType spells out the full TRF pattern (& join, F_II-style sub-versions, _EMC/_PS/_SOF test types) and a new iecex_trf docType documents the `_`/`v` separator and std-edition with verified examples. - PLATEAU page: the Handbook #11 edition-split rule (#6/#4 for editions 1-3) documented with verified rewrite examples. - Library: a Constructing Identifiers page — the v2 replacement for the v1 `Identifier.create` (typed `.new`, from_hash, supplement-with-base, copublishers, stages) — linked from the library index. - The publisher-count spec updates 38 -> 44 for the six new pages; 3GPP already had a page (flavor key "tgpp"). Sources: pubid/pubid-iso, pubid-iec, pubid-plateau README.adoc (archived); the pubid gem's lib/ and spec/fixtures/ as the correctness authority.
… would link-check it
…ecessor docTypes to the IEEE page
|
CI status note: the two
The workflow, lychee.toml and .lycheeignore are untouched by this branch. Rerun |
|
Follow-up on the CI note: the incident has partially cleared and the check now runs further — the current failure is a single external bot-block, not this PR.
Nothing in this PR needs changing for CI to go green; a rerun once ashrae.org stops challenging the checker is expected to pass. If the 403 proves persistent rather than flapping, the house convention would be a commented entry in |
Summary
Site-side half of the archived-README port (gem-side half: pubid/pubid#679). The website was missing six flavors the pubid 2 registry carries, and the usage narrative the archived per-gem READMEs held was absent from the ISO/IEC/PLATEAU publisher pages.
New publisher pages: doi, evs, gb, isbn, omg, un
Built from the monogem's identifier classes and pass fixtures. Every
outputvalue and syntax claim was verified by parsing the example with the gem:0-306-40615-2,9783161484100) parse at the flavor entry point with hyphenation preserved as given — the outputs state that exactlyDOI:/ resolver URLs all render canonicaldoi:…at the flavor entry point (global prefix routing requires thedoi:token)(all parts)Publisher.logobecomes optional (logo?: string) — the hero already rendered a two-letter badge fallback for missing assets; six of the new flavors have no logo file yet.src/data/__tests__/registry.spec.tsupdates the exact publisher count 38 → 44 with the rationale in a comment.3GPP deliberately not added: the site already carries a full 3GPP page at flavor key
tgpp(src/data/flavors/tgpp.ts) — an earlier filename-based audit mistook the gem's3gppregistry key for a gap.ISO page
stylesfield the FlavorPage template already renders): the live v2 rendering options — canonical detection,lang_single:(short stage + single-letter language),stage_format_long:(longAmd/DCor/FDCorfaces),with_date:(undated),with_edition:— with verified examples. The v1format: :ref_num_short-symbol API is not a v2 API.DAmd/FDAmdwith the verified canonicalization example.DIS Cor/FDIS Cor/FCORlegacy spellings canonicalize.IEC page
iecee_trfdocType now spells out the full TRF pattern from the archived pubid-iec README:&part join (,/;normalized), version letters with string sub-versions (F_II),_EMC/_PS/_SOFtest types — verified examples.iecex_trfdocType: the_(official pattern) vsv(IEC Webstore) separator, std-edition,A_DS-style sub-versions — verified examples.PLATEAU page
The Handbook #11 edition-split rule (editions 1–3: (民間活用編) was #6, (公共活用編) was #4; combined only from edition 4) documented in the Handbook docType and syntaxNotes, with the six verified rewrite examples — the rule lives in the gem's
data/plateau/update_codes.yamland was previously undocumented on both sides.Library
New Constructing Identifiers page (
/library/constructing-identifiers, linked from the library index): the v2 replacement for the v1Identifier.create— typed.new, the unknown-key refusal and scalar coercion,Pubid.from_hash, supplement-with-base (ISO/IEC/IEEE), copublishers, typed stages viaPubid::Iso.locate_stage. All snippets verified against the gem.Verification
astro check: 0 errors, 0 warningsvitest run: 429 passedastro build: 349 pages; all six new publisher pages, the IEEE AIEE/IRE docTypes, and the library page generatelycheerun locally over the new and modified pages: the only failing link is the pre-existing header linkgithub.com/pubid/pubid.github.io(a transient 504 present on every page including untouched ones); the content this PR adds introduces zero failing linkspubid/pubidlib/ andspec/fixtures/on the gem's current main