コンテンツにスキップ

はじめに

Oxiquill には Node.js 24 以上が必要です。実行可能 cell のない static starter は Node.js と npm/pnpm だけで動き、language toolchain は document manifest がその language を使うときだけ必要です。

supported starter command は dependency install や Git init をせずに新しい directory を作ります。

ターミナルウィンドウ
pnpm dlx oxiquill init my-docs
cd my-docs

my-docs を省略すると current directory を初期化します。target は未作成または空でなければならず、init は non-empty directory を上書きせず force option もありません。

既存 static documentation project に Oxiquill を追加する場合:

ターミナルウィンドウ
pnpm add oxiquill@0.5.0 "astro@^7.3.8" "@astrojs/starlight@~0.42.6"

または:

ターミナルウィンドウ
npm install oxiquill@0.5.0 "astro@^7.3.8" "@astrojs/starlight@~0.42.6"

starter が作成していない場合は package.json に次の script を追加します。

{
"scripts": {
"dev": "oxiquill dev",
"build": "oxiquill build",
"check": "oxiquill check",
"preview": "oxiquill preview",
"clean": "oxiquill clean"
}
}

astro.config.mjs:

import starlight from '@astrojs/starlight';
import { defineOxiquillConfig } from 'oxiquill/astro';
export default defineOxiquillConfig({
framework: { starlight },
site: 'https://example.com',
title: 'My Docs',
sidebar: [{ label: 'Overview', items: [{ label: 'Home', slug: 'index' }] }]
});

content.config.ts:

import { defineCollection } from 'astro:content';
import { docsLoader } from '@astrojs/starlight/loaders';
import { docsSchema } from '@astrojs/starlight/schema';
import { createOxiquillCollections } from 'oxiquill/content';
export const collections = createOxiquillCollections({ defineCollection, docsLoader, docsSchema });

最初の page を content/docs/index.mdx に書きます。

---
title: Home
description: Start writing with Oxiquill.
---
# Home
Write prose-first technical documentation in MDX.

source/cache/public/output path を変える前に プロジェクト設定 を確認してください。

project で選んだ package manager を使います。

ターミナルウィンドウ
pnpm install
pnpm check

または:

ターミナルウィンドウ
npm install
npm run check

check は project config を読み、cell metadata を検証し、必要な runtime/asset だけを生成して Astro type を同期し、Astro/MDX/TypeScript diagnostic を報告します。

ターミナルウィンドウ
pnpm dev

prose、通常 code block、math、Mermaid、media は Astro HMR を使います。cell/helper source の変更は対応 manifest/runtime を再生成します。Ctrl-C で server を停止します。

production site を作って確認します。

ターミナルウィンドウ
pnpm build
pnpm preview

build は strict generation/check 後に Astro の static outDir(通常 dist)を書きます。preview は既存 output を serve するだけで、production web server、TLS、domain、reverse proxy の代わりではありません。

ContentAuthor/build prerequisiteReader prerequisite
Static MDX、math、Mermaid、mediaNode.js 24+ と npm/pnpmsupported browser
Python cellgeneration 時の network または verified offline Pyodide cachesupported browser。asset は site が配信
Rust cellRust/Cargo 1.85.0 以上と wasm32-unknown-unknownsupported browser
Haskell cellLinux/macOS と wasm32-wasi-ghc 9.14任意 desktop OS の supported browser

repository maintainer は full validation suite 用に cargo-llvm-cov と Playwright browser も必要です。

Rust/Cargo は 1.85.0 以上に対応します。wasm32-unknown-unknown target が必要です。runtime pin と一致する wasm-bindgen CLI と Binaryen 117 の wasm-opt は、PATH 上のものを使うか自動的に download して検証します。Rust 1.85.0 を必須 CI で検証し、repository の開発には Rust 1.99.0 を使用します。Rust beta/nightly channel も数値 version が最低要件以上なら受け入れますが、未検証です。helper crate 自身がより新しい Rust を要求する場合は、その要件も満たす必要があります。

Oxiquill は .oxiquill/**、public/oxiquill/**、Astro type/cache output、dist/** を所有します。ignore し、CLI command から再生成してください。verified download は別の .cache/oxiquill/downloads/v1/** に置かれ、starter はこの directory を ignore し、oxiquill clean は後の online/offline 再生成用に保持します。matching manifest、fingerprint、runtime input が同一でない限り、config 間で生成物を copy しないでください。

続けて 執筆ガイド、CLI reference、トラブルシューティング を参照してください。

基準曲線・標本・不確実性を一つの図に重ねるには、Rust の emit_chart!、Python の display_chart、Haskell の displayChart から 混合 XY レイヤーを使います。独自の HTML は不要です。