[{"data":1,"prerenderedAt":602},["ShallowReactive",2],{"navigation":3,"api-navigation":109,"\u002Fdocs\u002Fcomparison\u002Fdocusaurus":110,"docyard:crossref-index":591},[4,14,97,101,105],{"title":5,"path":6,"stem":7,"children":8,"page":13},"Authoring","\u002Fauthoring","authoring",[9],{"title":10,"path":11,"stem":12},"Markdoc","\u002Fauthoring\u002Fmarkdoc","authoring\u002Fmarkdoc",false,{"title":15,"path":16,"stem":17,"children":18},"Docs","\u002Fdocs","docs",[19,22,26,30,34,55,59,63,93],{"title":20,"path":16,"stem":21},"Documentation","docs\u002Findex",{"title":23,"path":24,"stem":25},"Getting Started","\u002Fdocs\u002Fgetting-started","docs\u002F1.getting-started",{"title":27,"path":28,"stem":29},"Flake Module","\u002Fdocs\u002Fflake-module","docs\u002F2.flake-module",{"title":31,"path":32,"stem":33},"CLI Reference","\u002Fdocs\u002Fcli","docs\u002F3.cli",{"title":5,"path":35,"stem":36,"children":37},"\u002Fdocs\u002Fauthoring","docs\u002F4.authoring\u002Findex",[38,39,43,47,51],{"title":5,"path":35,"stem":36},{"title":40,"path":41,"stem":42},"Quarto Files","\u002Fdocs\u002Fauthoring\u002Fquarto","docs\u002F4.authoring\u002F1.quarto",{"title":44,"path":45,"stem":46},"Citations","\u002Fdocs\u002Fauthoring\u002Fcitations","docs\u002F4.authoring\u002F2.citations",{"title":48,"path":49,"stem":50},"Callouts","\u002Fdocs\u002Fauthoring\u002Fcallouts","docs\u002F4.authoring\u002F3.callouts",{"title":52,"path":53,"stem":54},"Cross-References","\u002Fdocs\u002Fauthoring\u002Fcross-references","docs\u002F4.authoring\u002F4.cross-references",{"title":56,"path":57,"stem":58},"Deployment","\u002Fdocs\u002Fdeployment","docs\u002F5.deployment",{"title":60,"path":61,"stem":62},"Search","\u002Fdocs\u002Fsearch","docs\u002F6.search",{"title":64,"path":65,"stem":66,"children":67},"Comparisons","\u002Fdocs\u002Fcomparison","docs\u002F7.comparison\u002Findex",[68,69,73,77,81,85,89],{"title":64,"path":65,"stem":66},{"title":70,"path":71,"stem":72},"Docyard vs. Docusaurus","\u002Fdocs\u002Fcomparison\u002Fdocusaurus","docs\u002F7.comparison\u002F1.docusaurus",{"title":74,"path":75,"stem":76},"Docyard vs. Sphinx","\u002Fdocs\u002Fcomparison\u002Fsphinx","docs\u002F7.comparison\u002F2.sphinx",{"title":78,"path":79,"stem":80},"Docyard vs. MkDocs","\u002Fdocs\u002Fcomparison\u002Fmkdocs","docs\u002F7.comparison\u002F3.mkdocs",{"title":82,"path":83,"stem":84},"Docyard vs. VitePress","\u002Fdocs\u002Fcomparison\u002Fvitepress","docs\u002F7.comparison\u002F4.vitepress",{"title":86,"path":87,"stem":88},"Docyard vs. Starlight","\u002Fdocs\u002Fcomparison\u002Fstarlight","docs\u002F7.comparison\u002F5.starlight",{"title":90,"path":91,"stem":92},"Docyard vs. GitBook","\u002Fdocs\u002Fcomparison\u002Fgitbook","docs\u002F7.comparison\u002F6.gitbook",{"title":94,"path":95,"stem":96},"Accessibility","\u002Fdocs\u002Faccessibility","docs\u002F8.accessibility",{"title":98,"path":99,"stem":100},"Docyard","\u002F","index",{"title":102,"path":103,"stem":104},"Notebook Demo","\u002Fnotebook-demo","notebook-demo",{"title":106,"path":107,"stem":108},"References","\u002Freferences","references",[],{"id":111,"title":70,"body":112,"description":585,"extension":586,"meta":587,"navigation":588,"path":71,"seo":589,"stem":72,"__hash__":590},"content\u002Fdocs\u002F7.comparison\u002F1.docusaurus.md",{"type":113,"value":114,"toc":573},"minimark",[115,119,134,139,313,317,320,347,359,362,366,369,428,439,442,446,453,487,494,498,501,535,539,545,551,555,558,570],[116,117,70],"h1",{"id":118},"docyard-vs-docusaurus",[120,121,122,129,130,133],"p",{},[123,124,128],"a",{"href":125,"rel":126},"https:\u002F\u002Fdocusaurus.io\u002F",[127],"nofollow","Docusaurus"," is the most popular open-source\ndocumentation framework, with a large React\u002Fnpm ecosystem behind it. Docyard\ntargets a narrower audience: technical and scientific projects that already use\nNix and want scholarly authoring plus multi-language API reference with as\nlittle JavaScript boilerplate as possible. See the\n",[123,131,132],{"href":65},"comparisons overview"," for how Docyard stacks up against the\nother tools.",[135,136,138],"h2",{"id":137},"at-a-glance","At a glance",[140,141,142,157],"table",{},[143,144,145],"thead",{},[146,147,148,153,155],"tr",{},[149,150,152],"th",{"align":151},"left","Dimension",[149,154,98],{"align":151},[149,156,128],{"align":151},[158,159,160,175,199,212,236,249,262,274,287,300],"tbody",{},[146,161,162,169,172],{},[163,164,165],"td",{"align":151},[166,167,168],"strong",{},"Philosophy",[163,170,171],{"align":151},"Technical, scholarly, Nix-native",[163,173,174],{"align":151},"General-purpose React\u002Fnpm documentation portal",[146,176,177,182,190],{},[163,178,179],{"align":151},[166,180,181],{},"Dev environment",[163,183,184,185,189],{"align":151},"Nix flake (no ",[186,187,188],"code",{},"node_modules"," for content authors)",[163,191,192,193,196,197],{"align":151},"Node.js with a local ",[186,194,195],{},"package.json"," \u002F ",[186,198,188],{},[146,200,201,206,209],{},[163,202,203],{"align":151},[166,204,205],{},"Setup mode",[163,207,208],{"align":151},"Managed (content-only) or explicit",[163,210,211],{"align":151},"Explicit only — you own the React app",[146,213,214,219,230],{},[163,215,216],{"align":151},[166,217,218],{},"Authoring format",[163,220,221,222,225,226,229],{"align":151},"Markdown, Quarto (",[186,223,224],{},".qmd","), Jupyter (",[186,227,228],{},".ipynb",")",[163,231,232,233,229],{"align":151},"Markdown and MDX (",[186,234,235],{},".mdx",[146,237,238,243,246],{},[163,239,240],{"align":151},[166,241,242],{},"Scholarly syntax",[163,244,245],{"align":151},"Built-in: citations, cross-refs, callouts, KaTeX",[163,247,248],{"align":151},"Manual remark\u002Frehype plugin configuration",[146,250,251,256,259],{},[163,252,253],{"align":151},[166,254,255],{},"API generation",[163,257,258],{"align":151},"Built-in: Python, Rust, TypeScript, OpenAPI",[163,260,261],{"align":151},"Third-party plugin per language (TypeDoc, Sphinx, …)",[146,263,264,268,271],{},[163,265,266],{"align":151},[166,267,60],{},[163,269,270],{"align":151},"Built-in: local, Pagefind, or Algolia DocSearch",[163,272,273],{"align":151},"Built-in local search + Algolia DocSearch",[146,275,276,281,284],{},[163,277,278],{"align":151},[166,279,280],{},"Versioning",[163,282,283],{"align":151},"Built-in multi-version sites (newer, see notes)",[163,285,286],{"align":151},"Mature, widely used built-in versioning",[146,288,289,294,297],{},[163,290,291],{"align":151},[166,292,293],{},"Localization",[163,295,296],{"align":151},"Not built in (roadmap)",[163,298,299],{"align":151},"First-class i18n with translation extraction",[146,301,302,307,310],{},[163,303,304],{"align":151},[166,305,306],{},"Ecosystem",[163,308,309],{"align":151},"Early-stage, small",[163,311,312],{"align":151},"Large community, thousands of plugins and themes",[135,314,316],{"id":315},"core-philosophy-and-developer-experience","Core philosophy and developer experience",[120,318,319],{},"The biggest practical difference is who maintains the JavaScript toolchain.",[120,321,322,325,326,330,331,196,334,336,337,339,340,342,343,346],{},[166,323,324],{},"Docyard is Nix-native."," It is consumed as a flake input. In ",[327,328,329],"em",{},"managed mode","\nyou write only ",[186,332,333],{},".md",[186,335,224],{}," files and set a handful of flake options; Docyard\nmaterializes the whole Nuxt app, wires up the content directory, runs API\nextraction, and builds. Content authors never touch ",[186,338,195],{}," or\n",[186,341,188],{},", and the toolchain is pinned reproducibly by the flake. An\n",[327,344,345],{},"explicit mode"," is available when you want to own a full Nuxt app and extend the\ntheme directly.",[120,348,349,352,353,355,356,358],{},[166,350,351],{},"Docusaurus is a React application you own."," You scaffold a site, manage its\n",[186,354,195],{}," and ",[186,357,188],{},", and keep the React\u002FWebpack toolchain up to\ndate over the project's lifetime. In exchange you get the full flexibility of a\nReact app and a very large ecosystem to draw on.",[120,360,361],{},"If your team already runs Nix and treats documentation as a build artifact of a\nlarger repo, Docyard removes a class of dependency upkeep. If you want maximum\nflexibility and aren't using Nix, Docusaurus's model is the better fit.",[135,363,365],{"id":364},"technical-and-scholarly-authoring","Technical and scholarly authoring",[120,367,368],{},"Docyard's reason to exist is scholarly and technical writing. The Quarto syntax\npipeline is built in, not bolted on:",[370,371,372,385,406,414,420],"ul",{},[373,374,375,377,378,355,381,384],"li",{},[166,376,44],{}," — ",[186,379,380],{},"@key",[186,382,383],{},"[@a; @b]"," resolve against a bibliography and\nrender a references section.",[373,386,387,377,390,393,394,397,398,401,402,405],{},[166,388,389],{},"Numbered cross-references",[186,391,392],{},"@fig-",", ",[186,395,396],{},"@tbl-",", and ",[186,399,400],{},"@eq-"," references are\nnumbered by a single numbering engine that works ",[327,403,404],{},"across files",", so figure,\ntable, and equation numbers stay consistent site-wide.",[373,407,408,377,410,413],{},[166,409,48],{},[186,411,412],{},"::: {.callout-note}"," fenced divs become styled blocks.",[373,415,416,419],{},[166,417,418],{},"Math"," — KaTeX display and inline math, with numbered equations.",[373,421,422,377,425,427],{},[166,423,424],{},"Jupyter notebooks",[186,426,228],{}," files are first-class content.",[120,429,430,431,434,435,438],{},"In Docusaurus the equivalent capabilities are assembled from separate remark \u002F\nrehype plugins (e.g. ",[186,432,433],{},"remark-math"," + ",[186,436,437],{},"rehype-katex","), and there is no native,\ncross-document numbering engine for figures, tables, and equations — that part\nyou build yourself.",[120,440,441],{},"Docyard also ships a benchmarks feature (tables and charts driven from data) for\nprojects that publish results alongside their docs.",[135,443,445],{"id":444},"api-documentation","API documentation",[120,447,448,449,452],{},"Docyard includes a single Go-based extractor, the ",[186,450,451],{},"docyard extract"," CLI, that\nproduces normalized JSON the site renders into API pages. It supports several\nlanguages out of the box:",[370,454,455,466,475,481],{},[373,456,457,460,461],{},[166,458,459],{},"Python"," — via ",[123,462,465],{"href":463,"rel":464},"https:\u002F\u002Fmkdocstrings.github.io\u002Fgriffe\u002F",[127],"griffe",[373,467,468,460,471,474],{},[166,469,470],{},"Rust",[186,472,473],{},"cargo doc"," JSON",[373,476,477,480],{},[166,478,479],{},"TypeScript"," — module API extraction",[373,482,483,486],{},[166,484,485],{},"OpenAPI"," — from a spec file",[120,488,489,490,493],{},"Because extraction is one CLI feeding one renderer, multi-language projects get\nconsistent API pages without stitching together TypeDoc, Sphinx, and bespoke\nbuild scripts. Docusaurus has no built-in API extraction; you wire up a\nper-language plugin (TypeDoc for TS, Sphinx\u002F",[186,491,492],{},"docusaurus-plugin"," bridges for\nPython, etc.) and reconcile their differing output.",[135,495,497],{"id":496},"where-docusaurus-is-ahead","Where Docusaurus is ahead",[120,499,500],{},"This is the honest part — and it is also Docyard's roadmap.",[370,502,503,513,523,529],{},[373,504,505,508,509,512],{},[166,506,507],{},"Localization (i18n)."," Docusaurus has first-class internationalization:\ntranslation-key extraction, per-locale builds, and a documented workflow.\nDocyard has ",[166,510,511],{},"no built-in localization"," today. This is the clearest gap.",[373,514,515,518,519,522],{},[166,516,517],{},"Versioning maturity."," Docyard ",[327,520,521],{},"does"," have built-in multi-version sites\n(version picker, per-version API extraction, historical content directories),\nbut the feature is newer and not yet documented here. Docusaurus's versioning\nis older, widely used, and well documented. Treat Docyard's as capable but\nless battle-tested.",[373,524,525,528],{},[166,526,527],{},"Ecosystem and community."," Docusaurus has thousands of community plugins,\nthemes, and presets (analytics, custom search UIs, blog tooling, …) and a\nlarge support community. Docyard's ecosystem is early-stage.",[373,530,531,534],{},[166,532,533],{},"React \u002F MDX customizability."," MDX makes embedding React components in a\npage native, backed by the large React SSG ecosystem. Docyard supports\ncomponent islands through Markdown components (MDC) on Vue\u002FNuxt, which is\npowerful but a smaller ecosystem.",[135,536,538],{"id":537},"decision-guide","Decision guide",[120,540,541,544],{},[166,542,543],{},"Choose Docyard if"," your project is a technical or scientific codebase,\nalready uses Nix, needs multi-language API reference (Python \u002F Rust \u002F TypeScript\n\u002F OpenAPI), and you want scholarly authoring (citations, cross-references, math)\nwith zero JavaScript boilerplate for content authors.",[120,546,547,550],{},[166,548,549],{},"Choose Docusaurus if"," you need mature internationalization, want the largest\nplugin and theme ecosystem, have a React team eager to build custom features\ninside the docs, or simply aren't using Nix.",[135,552,554],{"id":553},"roadmap","Roadmap",[120,556,557],{},"The gaps above are tracked as goals for Docyard:",[559,560,561,564,567],"ol",{},[373,562,563],{},"Built-in localization (i18n) with a translation workflow.",[373,565,566],{},"Documentation and hardening for multi-version sites.",[373,568,569],{},"A broader plugin \u002F theme story and customization presets.",[120,571,572],{},"If one of these is a blocker for you today, Docusaurus is the safer choice —\nrevisit Docyard as these land.",{"title":574,"searchDepth":575,"depth":575,"links":576},"",3,[577,579,580,581,582,583,584],{"id":137,"depth":578,"text":138},2,{"id":315,"depth":578,"text":316},{"id":364,"depth":578,"text":365},{"id":444,"depth":578,"text":445},{"id":496,"depth":578,"text":497},{"id":537,"depth":578,"text":538},{"id":553,"depth":578,"text":554},"A realistic comparison of Docyard and Docusaurus — design philosophies, feature trade-offs, and the gaps that make up Docyard's roadmap.","md",{},true,{"title":70,"description":585},"_270scjyRFz3FIZ58N2riq8u1b8Sq6FKyMrjI4VRnIA",{"fig-authoring-example":592,"tbl-authoring-demo":595,"eq-authoring-energy":597,"fig-pipeline":599,"tbl-solvers":600,"eq-loss":601},{"kind":593,"number":594,"path":11},"fig",1,{"kind":596,"number":594,"path":11},"tbl",{"kind":598,"number":594,"path":11},"eq",{"kind":593,"number":594,"path":53},{"kind":596,"number":594,"path":53},{"kind":598,"number":594,"path":53},1784218152249]