Merge branch 'main' into translate/html-elem

Author: gomazarashi

.github/workflows/website.yml

@@ -23,12 +23,12 @@ jobs:
         uses: actions/upload-artifact@ea165f8d65b6e75b540449e92b4886f43607fa02 # v4.6.2
         with:
           name: build-artifacts
-          path: website/dist
+          path: website/typst-docs-web/dist
       - name: Deploy
         if: github.ref == 'refs/heads/main'
         uses: JamesIves/github-pages-deploy-action@6c2d9db40f9296374acc17b90404b6e8864128c8 # v4.7.3
         with:
-          folder: website/dist # The folder the action should deploy.
+          folder: website/typst-docs-web/dist # The folder the action should deploy.
 
   textlint-md:
     runs-on: ubuntu-24.04
@@ -52,7 +52,7 @@ jobs:
         uses: actions/download-artifact@d3f86a106a0bac45b974a628896c90dbdf5c8093 # v4.3.0
         with:
           name: build-artifacts
-          path: website/dist
+          path: website/typst-docs-web/dist
       - uses: jdx/mise-action@13abe502c30c1559a5c37dff303831bab82c9402 # v2.2.3
       - name: Install dependencies
         run: bun install --frozen-lockfile
@@ -63,7 +63,7 @@ jobs:
     runs-on: ubuntu-24.04
     defaults:
       run:
-        working-directory: ./website
+        working-directory: website/typst-docs-web
     strategy:
       fail-fast: false
       matrix:

.mise.toml

@@ -1,3 +1,3 @@
 # hayagrivaのsrc/csl/archive.rsで管理されている参考文献フォーマット
-website/dist/reference/model/bibliography/index.html
-website/dist/reference/model/cite/index.html
+website/typst-docs-web/dist/reference/model/bibliography/index.html
+website/typst-docs-web/dist/reference/model/cite/index.html

.textlintignore

@@ -86,7 +86,7 @@ mise run textlint-md    # Markdownファイルを翻訳した場合
 miseが導入されている環境で初めて当プロジェクトのルートディレクトリに移動すると、以下のように構成ファイルを信頼することを求められます。
 
 ```plaintext
-mise ERROR Config file /path/to/typst-jp.github.io/.mise.toml is not trusted.
+mise ERROR Config file /path/to/typst-jp.github.io/mise.toml is not trusted.
 Trust it with `mise trust`.
 mise ERROR Run with --verbose or MISE_VERBOSE=1 for more information
 ```

CONTRIBUTING.md

@@ -21,7 +21,7 @@ use crate::foundations::{
 /// 関数名の直後に括弧で囲まれたカンマ区切りの関数の _引数_ のリストを書くことにより関数を呼び出すことができます。
 /// 加えて、通常の引数リストの後に任意の数のコンテンツブロック引数を関数に渡すこともできます。
 /// 通常の引数リストが空の場合は省略が可能です。
-/// Typstは位置引数とキーワード引数をサポートしています。
+/// Typstは位置引数と名前付き引数をサポートしています。
 /// 前者は位置と型によって識別され、後者は`name: value`のように書きます。
 ///
 /// 数式モードでは、関数呼び出しは特殊な振る舞いをします。
@@ -57,7 +57,7 @@ use crate::foundations::{
 ///
 /// # ユーザー定義関数
 /// [letバインディング]($scripting/#bindings)を用いることで、バインディング名の後に引数リストを持ったユーザー定義関数を定義することができます。
-/// 引数リストには必須の位置引数、デフォルト値を持つキーワード引数および[可変長引数]($arguments)を用いることができます。
+/// 引数リストには必須の位置引数、デフォルト値を持つ名前付き引数および[可変長引数]($arguments)を用いることができます。
 ///
 /// 関数バインディングの右辺は関数本体で、ブロックか任意の式です。
 /// 関数の戻り値を定義し、引数に依存させることができます。

bun.lock

@@ -12,14 +12,14 @@ use crate::World;
 
 /// 出力されるPDFに埋め込まれるファイル。
 ///
-/// This can be used to distribute additional files that are related to the PDF
-/// within it. PDF readers will display the files in a file listing.
+/// この関数は、PDFに関連する追加のファイルをPDF内に埋め込んで配布するために使用できます。
+/// PDFリーダーはファイルリストにファイルを表示します。
 ///
-/// Some international standards use this mechanism to embed machine-readable
-/// data (e.g., ZUGFeRD/Factur-X for invoices) that mirrors the visual content
-/// of the PDF.
+/// 一部の国際規格では、
+/// この仕組みを使用して、
+/// PDFの視覚的な内容を反映した機械可読データ（例：請求書のZUGFeRD/Factur-X）を埋め込んでいます。
 ///
-/// # Example
+/// # 例
 /// ```typ
 /// #pdf.embed(
 ///   "experiment.csv",
@@ -29,16 +29,16 @@ use crate::World;
 /// )
 /// ```
 ///
-/// # Notes
-/// - This element is ignored if exporting to a format other than PDF.
-/// - File embeddings are not currently supported for PDF/A-2, even if the
-///   embedded file conforms to PDF/A-1 or PDF/A-2.
+/// # 注意
+/// - この要素はPDF以外の形式にエクスポートする場合は無視されます。
+/// - PDF/A-2へのエクスポートでは、埋め込みファイルは現在サポートされていません。
+///   たとえ埋め込まれるファイルがPDF/A-1やPDF/A-2に準拠していたとしてもです。
 #[elem(Show, Locatable)]
 pub struct EmbedElem {
-    /// The [path]($syntax/#paths) of the file to be embedded.
+    /// 埋め込まれるファイルの[パス]($syntax/#paths)。
     ///
-    /// Must always be specified, but is only read from if no data is provided
-    /// in the following argument.
+    /// 常に指定する必要がありますが、
+    /// 次の引数でデータが提供されていない場合にのみ読み取られます。
     #[required]
     #[parse(
         let Spanned { v: path, span } =
@@ -51,9 +51,9 @@ pub struct EmbedElem {
     #[borrowed]
     pub path: Derived<EcoString, EcoString>,
 
-    /// Raw file data, optionally.
+    /// 任意で指定する生のファイルデータ。
     ///
-    /// If omitted, the data is read from the specified path.
+    /// この引数が指定されない場合、データは指定されたパスから読み取られます。
     #[positional]
     // Not actually required as an argument, but always present as a field.
     // We can't distinguish between the two at the moment.
@@ -66,16 +66,16 @@ pub struct EmbedElem {
     )]
     pub data: Bytes,
 
-    /// The relationship of the embedded file to the document.
+    /// 埋め込まれるファイルと文書との関係。
     ///
-    /// Ignored if export doesn't target PDF/A-3.
+    /// エクスポート対象がPDF/A-3でない場合は無視されます。
     pub relationship: Option<EmbeddedFileRelationship>,
 
-    /// The MIME type of the embedded file.
+    /// 埋め込まれるファイルのMIMEタイプ。
     #[borrowed]
     pub mime_type: Option<EcoString>,
 
-    /// A description for the embedded file.
+    /// 埋め込まれるファイルの説明。
     #[borrowed]
     pub description: Option<EcoString>,
 }
@@ -94,12 +94,12 @@ impl Show for Packed<EmbedElem> {
 /// The relationship of an embedded file with the document.
 #[derive(Debug, Copy, Clone, Eq, PartialEq, Hash, Cast)]
 pub enum EmbeddedFileRelationship {
-    /// The PDF document was created from the source file.
+    /// PDF文書がそのソースファイルから作成されたことを示す。
     Source,
-    /// The file was used to derive a visual presentation in the PDF.
+    /// ファイルがPDFにおける視覚的表現を得るために使われたことを示す。
     Data,
-    /// An alternative representation of the document.
+    /// 文書の代替的な表現であることを示す。
     Alternative,
-    /// Additional resources for the document.
+    /// 文書への追加のリソースであることを示す。
     Supplement,
 }

bun.lockb

@@ -1,61 +1,61 @@
 <div class="info-box">
 
-Typst's HTML export is currently under active development. The feature is still
-very incomplete and only available for experimentation behind a feature flag. Do
-not use this feature for production use cases. In the CLI, you can experiment
-with HTML export by passing `--features html` or setting the `TYPST_FEATURES`
-environment variables to `html`. In the web app, HTML export is not available at
-this time. Visit the [tracking issue](https://github.com/typst/typst/issues/5512)
-to follow progress on HTML export and learn more about planned features.
+TypstのHTMLエクスポートは現在積極的に開発が行われています。
+この機能はまだ非常に不完全であり、機能フラグを有効にした場合に、実験目的でのみ利用可能です。
+本番環境における利用ではこの機能を使用しないでください。
+CLIでは`--features html`オプションを指定するか環境変数`TYPST_FEATURES`に`html`を設定することでHTMLエクスポートを試すことができます。
+Webアプリでは、現時点でHTMLエクスポートは利用できません。
+HTMLエクスポートに関する進捗を追跡し、計画されている機能について詳しく知るには、
+[tracking issue](https://github.com/typst/typst/issues/5512)を参照してください。
 </div>
 
-HTML files describe a document structurally. The aim of Typst's HTML export is
-to capture the structure of an input document and produce semantically rich HTML
-that retains this structure. The resulting HTML should be accessible,
-human-readable, and editable by hand and downstream tools.
-
-PDF, PNG, and SVG export, in contrast, all produce _visual_ representations of a
-fully-laid out document. This divergence in the formats' intents means that
-Typst cannot simply produce perfect HTML for your existing Typst documents. It
-cannot always know what the best semantic HTML representation of your content
-is.
-
-Instead, it gives _you_ full control: You can check the current export format
-through the [`target`]($target) function and when it is set to HTML, generate [raw HTML
-elements]($html.elem). The primary intended use of these elements is in
-templates and show rules. This way, the document's contents can be fully
-agnostic to the export target and content can be shared between PDF and HTML
-export.
-
-Currently, Typst will always output a single HTML file. Support for outputting
-directories with multiple HTML documents and assets, as well as support for
-outputting fragments that can be integrated into other HTML documents is
-planned.
-
-Typst currently does not output CSS style sheets, instead focussing on emitting
-semantic markup. You can of course write your own CSS styles and still benefit
-from sharing your _content_ between PDF and HTML. For the future, we plan to
-give you the option of automatically emitting CSS, taking more of your existing
-set rules into account.
-
-# Exporting as HTML
-## Command Line
-Pass `--format html` to the `compile` or `watch` subcommand or provide an output
-file name that ends with `.html`. Note that you must also pass `--features html`
-or set `TYPST_FEATURES=html` to enable this experimental export target.
-
-When using `typst watch`, Typst will spin up a live-reloading HTTP server. You
-can configure it as follows:
-
-- Pass `--port` to change the port. (Defaults to the first free port in the
-  range 3000-3005.)
-- Pass `--no-reload` to disable injection of a live reload script. (The HTML
-  that is written to disk isn't affected either way.)
-- Pass `--no-serve` to disable the server altogether.
-
-## Web App
-Not currently available.
-
-# HTML-specific functionality
-Typst exposes HTML-specific functionality in the global `html` module. See below
-for the definitions it contains.
+HTMLファイルでは文書を構造的に記述します。
+TypstのHTMLエクスポートの目的は、入力文書の構造を捉え、
+この構造を保持する、意味付けが豊かなHTMLを生成することです。
+生成されるHTMLは、アクセシビリティに優れ、人間が読みやすく、手作業での編集や下流のツールによる処理が可能であるべきです。
+
+対照的に、PDF、PNG、SVGエクスポートはすべて、
+完全にレイアウト済みの文書の _視覚的_ 表現を生成します。
+このようなフォーマットの意図の違いにより、
+Typstは既存のTypst文書に対して完璧なHTMLを単純に生成することはできません。
+Typstがあなたのコンテンツにとって最適に意味付けされたHTML表現が何であるかを常に知ることはできないためです。
+
+代わりに、Typstは _あなた_ に完全な制御を委ねます。
+[`target`]($target)関数で現在のエクスポート形式を確認でき、これがHTMLに設定されている場合、
+[生のHTML要素]($html.elem)を生成できます。
+これらの要素は主にテンプレートやshowルールでの使用を想定しています。
+このようにすることで、
+文書の内容はエクスポート先に依存せず、PDFとHTMLの両方で共有できます。
+
+現時点では、
+Typstは常に単一のHTMLファイルを出力します。
+複数のHTML文書やアセットを含むディレクトリの出力、
+他のHTML文書に統合できるフラグメント出力は今後の実装が予定されています。
+
+Typstは現状ではCSSスタイルシートを出力せず、意味付けされたマークアップの生成に重点を置いています。
+もちろん、独自にCSSスタイルを書くこともでき、
+そうすればPDFとHTMLの間で _コンテンツ_ を共有する利点をそのまま享受できます。
+将来的には、既存のsetルールをより多く考慮に入れた上で、
+CSSを自動的に出力するオプションを提供する予定です。
+
+# HTML形式でのエクスポート
+## コマンドライン
+`compile`または`watch`サブコマンドに`--format html`オプションを指定するか、`.html`で終わる出力ファイル名を指定します。
+この実験的なエクスポートターゲットを有効にするには、`--features html`オプションを指定するか、
+環境変数`TYPST_FEATURES=html`を設定する必要があることに注意してください。
+
+`typst watch`を使用すると、Typstはライブリロード対応のHTTPサーバーを起動します。
+設定は以下の方法で可能です。
+
+- `--port`オプションでポート番号を変更します。
+（デフォルトでは3000-3005の範囲で最初に利用可能なポートが使用されます）。
+- `--no-reload`オプションでライブリロードスクリプトの注入を無効にします。
+（いずれにせよディスクに書き込まれるHTMLには影響しません）。
+- `--no-serve`オプションでサーバー機能が完全に無効になります。
+
+## Webアプリ
+現在利用できません。
+
+# HTML固有の機能
+Typstでは、グローバルな`html`モジュールを通じてHTMLに固有の機能を提供しています。
+そのモジュールに含まれる定義については、以下を参照してください。

crates/typst-library/src/foundations/func.rs

@@ -44,7 +44,7 @@ $ sum_(k=0)^n k
 
 - その中では、Typstは依然として「数式モード」です。
 したがって、その中で数式を直接書くことができますが、コード式を渡すには（数式構文で利用可能なstringを除いて）ハッシュ構文を使う必要があります。
-- 位置引数、キーワード引数、引数展開をサポートしています。
+- 位置引数、名前付き引数、引数展開をサポートしています。
 - 後続のコンテンツブロックはサポートされていません。
 - 2次元引数リストのための追加の構文があります。
 セミコロン（`;`）はその前のカンマ区切りの引数を配列引数へとマージします。