[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"docs:releasing":3},{"versions":4,"version":13,"nav":16,"path":66,"page":80},[5,10],{"name":6,"label":7,"prefix":8,"channel":9},"0.1","0.1.0 (latest)","","latest",{"name":11,"label":12,"prefix":11,"channel":11},"next","next (main)",{"name":6,"label":7,"prefix":8,"channel":9,"base":14,"ref":15},"\u002Fdocs","v0.1.0",[17,21,24,27,30,33,36,39,43,46,49,52,55,58,61,65,68,71,74,77],{"slug":18,"title":19,"group":20},"index","Overview","Guide",{"slug":22,"title":23,"group":20},"getting-started","Getting started",{"slug":25,"title":26,"group":20},"php","PHP API",{"slug":28,"title":29,"group":20},"laravel","Laravel",{"slug":31,"title":32,"group":20},"resources","Resources",{"slug":34,"title":35,"group":20},"deployment","Deployment",{"slug":37,"title":38,"group":20},"troubleshooting","Troubleshooting",{"slug":40,"title":41,"group":42},"css","CSS reference","Reference",{"slug":44,"title":45,"group":42},"paged-media","Paged media",{"slug":47,"title":48,"group":42},"fonts","Fonts",{"slug":50,"title":51,"group":42},"extensions","Extensions",{"slug":53,"title":54,"group":42},"pdf","The PDF",{"slug":56,"title":57,"group":42},"cli","Command line",{"slug":59,"title":60,"group":42},"rust","Rust library",{"slug":62,"title":63,"group":64},"protocol","Worker protocol","Internals",{"slug":66,"title":67,"group":64},"releasing","Releasing",{"slug":69,"title":70,"group":64},"adr\u002F0001-record-architecture-decisions","1. Record architecture decisions",{"slug":72,"title":73,"group":64},"adr\u002F0002-rust-and-fragmentation-in-layout","2. Rust core with fragmentation inside layout",{"slug":75,"title":76,"group":64},"adr\u002F0003-css-parsing-and-own-selector-matching","3. lightningcss for parsing, own selector matching and cascade",{"slug":78,"title":79,"group":64},"adr\u002F0004-extensions-only-where-css-has-no-way","4. Extensions only where CSS has no way",{"title":67,"seoTitle":81,"seoDescription":82,"html":83,"headings":84,"editUrl":89,"sourceUrl":90,"markdownUrl":91,"prev":92,"next":93},"Releasing · Fagus docs","A release consists of the fagus binary for every platform, attached to a GitHub release of nforst\u002Ffagus, and the Composer package nforst\u002Ffagus, which installs the binary of its release and accepts no other: …","\u003Ch1 id=\"releasing\">Releasing\u003C\u002Fh1>\n\u003Cp>A release consists of the \u003Ccode>fagus\u003C\u002Fcode> binary for every platform, attached to a GitHub release of \u003Ccode>nforst\u002Ffagus\u003C\u002Fcode>, and the Composer package \u003Ccode>nforst\u002Ffagus\u003C\u002Fcode>, which installs the binary of its release and accepts no other: \u003Ccode>php\u002Ffagus\u002Fsrc\u002FInternal\u002FRelease.php\u003C\u002Fcode> lists the SHA-256 of each binary.\u003C\u002Fp>\n\u003Col>\n\u003Cli>\n\u003Cp>\u003Cstrong>Prepare.\u003C\u002Fstrong> Set the version in \u003Ccode>Cargo.toml\u003C\u002Fcode> (\u003Ccode>[workspace.package]\u003C\u002Fcode>), move the entries under \u003Ccode>[Unreleased]\u003C\u002Fcode> in \u003Ccode>CHANGELOG.md\u003C\u002Fcode> to the new version, run \u003Ccode>tools\u002Fnotices.sh\u003C\u002Fcode> (it rewrites \u003Ccode>THIRD-PARTY-NOTICES\u003C\u002Fcode> with the licenses of the crates the binary is built from; it needs \u003Ccode>cargo install --locked cargo-about --features cli\u003C\u002Fcode>) and commit.\u003C\u002Fp>\n\u003C\u002Fli>\n\u003Cli>\n\u003Cp>\u003Cstrong>Build.\u003C\u002Fstrong> Run the workflow \u003Cem>Release\u003C\u002Fem> (\u003Ccode>.github\u002Fworkflows\u002Frelease.yml\u003C\u002Fcode>) on that commit with the version, for example \u003Ccode>gh workflow run release.yml -f version=0.1.0\u003C\u002Fcode>. It builds the binaries for Linux (x64 and arm64, glibc 2.17 and musl), macOS (x64 and arm64) and Windows (x64), checks that those the runners can run render a document, and attaches them with their sums (\u003Ccode>SHA256SUMS\u003C\u002Fcode>) to a draft release \u003Ccode>v0.1.0\u003C\u002Fcode>.\u003C\u002Fp>\n\u003C\u002Fli>\n\u003Cli>\n\u003Cp>\u003Cstrong>Pin.\u003C\u002Fstrong> Fetch the sums and write them into the PHP package:\u003C\u002Fp>\n\u003Cdiv class=\"f-doc-code\">\u003Cdiv class=\"f-doc-code-bar\">\u003Cspan>sh\u003C\u002Fspan>\u003Cbutton type=\"button\" class=\"f-doc-copy\" data-copy aria-label=\"Copy code\">\u003Csvg xmlns=\"http:\u002F\u002Fwww.w3.org\u002F2000\u002Fsvg\" viewBox=\"0 0 24 24\" fill=\"none\" stroke=\"currentColor\" stroke-width=\"2\" stroke-linecap=\"round\" stroke-linejoin=\"round\" aria-hidden=\"true\">\u003Crect width=\"14\" height=\"14\" x=\"8\" y=\"8\" rx=\"2\"\u002F>\u003Cpath d=\"M4 16c-1.1 0-2-.9-2-2V4c0-1.1.9-2 2-2h10c1.1 0 2 .9 2 2\"\u002F>\u003C\u002Fsvg>\u003Cspan>Copy\u003C\u002Fspan>\u003C\u002Fbutton>\u003C\u002Fdiv>\u003Cpre class=\"shiki github-dark-default\" style=\"background-color:#0d1117;color:#e6edf3\" tabindex=\"0\">\u003Ccode>\u003Cspan class=\"line\" style=\"padding-left:2ch;text-indent:-2ch\">\u003Cspan style=\"color:#FFA657\">gh\u003C\u002Fspan>\u003Cspan style=\"color:#A5D6FF\"> release\u003C\u002Fspan>\u003Cspan style=\"color:#A5D6FF\"> download\u003C\u002Fspan>\u003Cspan style=\"color:#A5D6FF\"> v0.1.0\u003C\u002Fspan>\u003Cspan style=\"color:#79C0FF\"> -p\u003C\u002Fspan>\u003Cspan style=\"color:#A5D6FF\"> SHA256SUMS\u003C\u002Fspan>\u003Cspan style=\"color:#79C0FF\"> -D\u003C\u002Fspan>\u003Cspan style=\"color:#A5D6FF\"> \u002Ftmp\u002Ffagus-0.1.0\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\" style=\"padding-left:2ch;text-indent:-2ch\">\u003Cspan style=\"color:#FFA657\">php\u003C\u002Fspan>\u003Cspan style=\"color:#A5D6FF\"> tools\u002Fpin-binaries.php\u003C\u002Fspan>\u003Cspan style=\"color:#79C0FF\"> 0.1.0\u003C\u002Fspan>\u003Cspan style=\"color:#A5D6FF\"> \u002Ftmp\u002Ffagus-0.1.0\u002FSHA256SUMS\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\" style=\"padding-left:2ch;text-indent:-2ch\">\u003Cspan style=\"color:#FFA657\">git\u003C\u002Fspan>\u003Cspan style=\"color:#A5D6FF\"> commit\u003C\u002Fspan>\u003Cspan style=\"color:#79C0FF\"> -am\u003C\u002Fspan>\u003Cspan style=\"color:#A5D6FF\"> \"chore: pin the binaries of 0.1.0\"\u003C\u002Fspan>\u003C\u002Fspan>\u003C\u002Fcode>\u003C\u002Fpre>\u003C\u002Fdiv>\n\u003Cp>This commit changes nothing but \u003Ccode>Release.php\u003C\u002Fcode>, so the binaries are those of the code it is tagged with.\u003C\u002Fp>\n\u003C\u002Fli>\n\u003Cli>\n\u003Cp>\u003Cstrong>Check.\u003C\u002Fstrong> Install the binary as a user would, from the files of the draft: GitHub does not hand out a draft by its tag, so fetch them (\u003Ccode>gh release download v0.1.0 -D \u002Ftmp\u002Ffagus-0.1.0\u003C\u002Fcode>) and set \u003Ccode>FAGUS_DOWNLOAD_URL=\u002Ftmp\u002Ffagus-0.1.0\u003C\u002Fcode>, which the installer checks against the pinned sums like a download. Then run the corpus checks: \u003Ccode>tools\u002Fvalidate.sh\u003C\u002Fcode> and the comparison with Chrome.\u003C\u002Fp>\n\u003C\u002Fli>\n\u003Cli>\n\u003Cp>\u003Cstrong>Tag and publish.\u003C\u002Fstrong> Tag the pin commit \u003Ccode>v0.1.0\u003C\u002Fcode>, push the tag, then publish the draft release, which takes the existing tag. The Composer package is released with the same tag: Packagist reads \u003Ccode>composer.json\u003C\u002Fcode> at the root of this repository.\u003C\u002Fp>\n\u003C\u002Fli>\n\u003C\u002Fol>\n\u003Ch2 id=\"composer\">Composer\u003Ca class=\"f-doc-anchor\" href=\"#composer\" aria-label=\"Link to this section\">#\u003C\u002Fa>\u003C\u002Fh2>\n\u003Cp>The Composer package \u003Ccode>nforst\u002Ffagus\u003C\u002Fcode> is this repository: \u003Ccode>composer.json\u003C\u002Fcode> at the root, the PHP code in \u003Ccode>php\u002Ffagus\u003C\u002Fcode> (\u003Ccode>Fagus\\\u003C\u002Fcode>) and \u003Ccode>php\u002Flaravel\u003C\u002Fcode> (\u003Ccode>Fagus\\Laravel\\\u003C\u002Fcode>, registered by Laravel's package discovery). \u003Ccode>.gitattributes\u003C\u002Fcode> leaves the engine's sources, tests and tools out of the archives Composer downloads, so an installation holds only the PHP code and the binary.\u003C\u002Fp>\n\u003Cp>Packagist lists the package from \u003Ccode>https:\u002F\u002Fgithub.com\u002Fnforst\u002Ffagus\u003C\u002Fcode> and updates it on every push and tag through GitHub's webhook. Before a release is tagged, a project can try a branch through a \u003Ccode>vcs\u003C\u002Fcode> repository:\u003C\u002Fp>\n\u003Cdiv class=\"f-doc-code\">\u003Cdiv class=\"f-doc-code-bar\">\u003Cspan>json\u003C\u002Fspan>\u003Cbutton type=\"button\" class=\"f-doc-copy\" data-copy aria-label=\"Copy code\">\u003Csvg xmlns=\"http:\u002F\u002Fwww.w3.org\u002F2000\u002Fsvg\" viewBox=\"0 0 24 24\" fill=\"none\" stroke=\"currentColor\" stroke-width=\"2\" stroke-linecap=\"round\" stroke-linejoin=\"round\" aria-hidden=\"true\">\u003Crect width=\"14\" height=\"14\" x=\"8\" y=\"8\" rx=\"2\"\u002F>\u003Cpath d=\"M4 16c-1.1 0-2-.9-2-2V4c0-1.1.9-2 2-2h10c1.1 0 2 .9 2 2\"\u002F>\u003C\u002Fsvg>\u003Cspan>Copy\u003C\u002Fspan>\u003C\u002Fbutton>\u003C\u002Fdiv>\u003Cpre class=\"shiki github-dark-default\" style=\"background-color:#0d1117;color:#e6edf3\" tabindex=\"0\">\u003Ccode>\u003Cspan class=\"line\" style=\"padding-left:2ch;text-indent:-2ch\">\u003Cspan style=\"color:#A5D6FF\">\"repositories\"\u003C\u002Fspan>\u003Cspan style=\"color:#E6EDF3\">: [{ \u003C\u002Fspan>\u003Cspan style=\"color:#7EE787\">\"type\"\u003C\u002Fspan>\u003Cspan style=\"color:#E6EDF3\">: \u003C\u002Fspan>\u003Cspan style=\"color:#A5D6FF\">\"vcs\"\u003C\u002Fspan>\u003Cspan style=\"color:#E6EDF3\">, \u003C\u002Fspan>\u003Cspan style=\"color:#7EE787\">\"url\"\u003C\u002Fspan>\u003Cspan style=\"color:#E6EDF3\">: \u003C\u002Fspan>\u003Cspan style=\"color:#A5D6FF\">\"https:\u002F\u002Fgithub.com\u002Fnforst\u002Ffagus\"\u003C\u002Fspan>\u003Cspan style=\"color:#E6EDF3\"> }]\u003C\u002Fspan>\u003C\u002Fspan>\u003C\u002Fcode>\u003C\u002Fpre>\u003C\u002Fdiv>\n\u003Cp>A development version has no pinned binaries, so the plugin installs none; set \u003Ccode>FAGUS_BINARY\u003C\u002Fcode> to a binary built from the same commit.\u003C\u002Fp>\n",[85],{"id":86,"text":87,"level":88},"composer","Composer",2,"https:\u002F\u002Fgithub.com\u002Fnforst\u002Ffagus\u002Fedit\u002Fmain\u002Fdocs\u002Freleasing.md","https:\u002F\u002Fgithub.com\u002Fnforst\u002Ffagus\u002Fblob\u002Fv0.1.0\u002Fdocs\u002Freleasing.md","\u002Fdocs\u002Freleasing.md",{"slug":62,"title":63},{"slug":69,"title":70}]