docs: docs/i18n/を更新

Author: 3w36zj6

docs/i18n/category/data-loading-en.yaml

@@ -96,6 +96,8 @@ children:
         equivalents, null-values (<code>null</code>, <code>~</code> or empty ``) will be converted into
         <code><span class="typ-key">none</span></code>, and numbers will be converted to floats or integers depending on
         whether they are whole numbers.</p>
+        <p>Be aware that integers larger than 2<sup>63</sup>-1 will be converted to
+        floating point numbers, which may result in an approximative value.</p>
       example: null
       self: false
       params:
@@ -394,12 +396,16 @@ children:
       contextual: false
       details: |-
         <p>Reads structured data from a JSON file.</p>
-        <p>The file must contain a valid JSON object or array. JSON objects will be
-        converted into Typst dictionaries, and JSON arrays will be converted into
-        Typst arrays. Strings and booleans will be converted into the Typst
-        equivalents, <code>null</code> will be converted into <code><span class="typ-key">none</span></code>, and numbers will be
-        converted to floats or integers depending on whether they are whole numbers.</p>
-        <p>The function returns a dictionary or an array, depending on the JSON file.</p>
+        <p>The file must contain a valid JSON value, such as object or array. JSON
+        objects will be converted into Typst dictionaries, and JSON arrays will be
+        converted into Typst arrays. Strings and booleans will be converted into the
+        Typst equivalents, <code>null</code> will be converted into <code><span class="typ-key">none</span></code>, and numbers will
+        be converted to floats or integers depending on whether they are whole
+        numbers.</p>
+        <p>Be aware that integers larger than 2<sup>63</sup>-1 will be converted to
+        floating point numbers, which may result in an approximative value.</p>
+        <p>The function returns a dictionary, an array or, depending on the JSON file,
+        another JSON data type.</p>
         <p>The JSON files in the example contain objects with the keys <code>temperature</code>,
         <code>unit</code>, and <code>weather</code>.</p>
         <h2 id="example">Example</h2>
@@ -918,6 +924,8 @@ children:
         <code><span class="typ-key">none</span></code>, and numbers will be converted to floats or integers depending on
         whether they are whole numbers. Custom YAML tags are ignored, though the
         loaded value will still be present.</p>
+        <p>Be aware that integers larger than 2<sup>63</sup>-1 will be converted to
+        floating point numbers, which may give an approximative value.</p>
         <p>The YAML files in the example contain objects with authors as keys,
         each with a sequence of their own submapping with the keys
         &quot;title&quot; and &quot;published&quot;</p>

docs/i18n/category/foundations-en.yaml

@@ -31,6 +31,10 @@ body:
       route: /docs/reference/foundations/assert/
       oneliner: Ensures that a condition is fulfilled.
       code: true
+    - name: auto
+      route: /docs/reference/foundations/auto/
+      oneliner: A value that indicates a smart default.
+      code: true
     - name: bool
       route: /docs/reference/foundations/bool/
       oneliner: A type with two states.
@@ -83,6 +87,10 @@ body:
       route: /docs/reference/foundations/module/
       oneliner: An evaluated module, either built-in or resulting from a file.
       code: true
+    - name: none
+      route: /docs/reference/foundations/none/
+      oneliner: A value that indicates the absence of any other value.
+      code: true
     - name: panic
       route: /docs/reference/foundations/panic/
       oneliner: Fails with an error.
@@ -1709,6 +1717,31 @@ children:
         returns: []
         scope: []
   children: []
+- route: /docs/reference/foundations/auto/
+  title: Auto
+  description: Documentation for the Auto type.
+  part: null
+  outline:
+  - id: summary
+    name: Summary
+    children: []
+  body:
+    kind: type
+    content:
+      name: auto
+      title: Auto
+      keywords: []
+      oneliner: A value that indicates a smart default.
+      details: |-
+        <p>A value that indicates a smart default.</p>
+        <p>The auto type has exactly one value: <code><span class="typ-key">auto</span></code>.</p>
+        <p>Parameters that support the <code><span class="typ-key">auto</span></code> value have some smart default or
+        contextual behaviour. A good example is the <a href="/docs/reference/text/text/#parameters-dir">text direction</a>
+        parameter. Setting it to <code><span class="typ-key">auto</span></code> lets Typst automatically determine the
+        direction from the <a href="/docs/reference/text/text/#parameters-lang">text language</a>.</p>
+      constructor: null
+      scope: []
+  children: []
 - route: /docs/reference/foundations/bool/
   title: Boolean
   description: Documentation for the Boolean type.
@@ -5851,6 +5884,36 @@ children:
       constructor: null
       scope: []
   children: []
+- route: /docs/reference/foundations/none/
+  title: None
+  description: Documentation for the None type.
+  part: null
+  outline:
+  - id: summary
+    name: Summary
+    children: []
+  - id: example
+    name: Example
+    children: []
+  body:
+    kind: type
+    content:
+      name: none
+      title: None
+      keywords: []
+      oneliner: A value that indicates the absence of any other value.
+      details: |-
+        <p>A value that indicates the absence of any other value.</p>
+        <p>The none type has exactly one value: <code><span class="typ-key">none</span></code>.</p>
+        <p>When inserted into the document, it is not visible. This is also the value
+        that is produced by empty code blocks. It can be
+        <a href="/docs/reference/scripting/#blocks">joined</a> with any value, yielding the other value.</p>
+        <h2 id="example">Example</h2>
+        <div class="previewed-code"><pre><code>Not visible: <span class="typ-key">#</span><span class="typ-key">none</span>
+        </code></pre><div class="preview"><img src="/assets/docs/6caa7433f3f477e3c7cfb6d6b041af0d.png" alt="Preview" width="480" height="190"/></div></div>
+      constructor: null
+      scope: []
+  children: []
 - route: /docs/reference/foundations/panic/
   title: Panic
   description: Documentation for the `panic` function.
@@ -7300,7 +7363,8 @@ children:
         self: true
         params:
         - name: pattern
-          details: <p>The pattern to search for.</p>
+          details: <p>The pattern to search for. If <code><span class="typ-key">none</span></code>,
+            trims white spaces.</p>
           example: null
           types:
           - none
@@ -7315,8 +7379,8 @@ children:
           settable: false
         - name: at
           details: |-
-            <p>Can be <code>start</code> or <code>end</code> to only trim the start or end of the string.
-            If omitted, both sides are trimmed.</p>
+            <p>Can be <code>start</code> or <code>end</code> to only trim the start or end of the
+            string. If omitted, both sides are trimmed.</p>
           example: null
           types:
           - alignment

docs/i18n/category/introspection-en.yaml

@@ -594,8 +594,8 @@ children:
         page number, typically you want the logical page number that may, for
         instance, have been reset after a preface.</p>
         <h2 id="examples">Examples</h2>
-        <p>Determining the current position in the document in combination with
-        <a href="/docs/reference/introspection/locate/" title="`locate`"><code>locate</code></a>:</p>
+        <p>Determining the current position in the document in combination with the
+        <a href="/docs/reference/introspection/location/#definitions-position"><code>position</code></a> method:</p>
         <div class="previewed-code"><pre><code><span class="typ-key">#</span><span class="typ-key">context</span> <span class="typ-punct">[</span>
           I am located at
           <span class="typ-func">#</span><span class="typ-func">here</span><span class="typ-punct">(</span><span class="typ-punct">)</span><span class="typ-punct">.</span><span class="typ-func">position</span><span class="typ-punct">(</span><span class="typ-punct">)</span>
@@ -848,7 +848,8 @@ children:
       details: |-
         <p>Exposes a value to the query system without producing visible content.</p>
         <p>This element can be retrieved with the <a href="/docs/reference/introspection/query/" title="`query`"><code>query</code></a> function and from the
-        command line with <a href="/docs/reference/meta/query/#cli-queries"><code>typst query</code></a>. Its
+        command line with
+        <a href="/docs/reference/introspection/query/#command-line-queries"><code>typst query</code></a>. Its
         purpose is to expose an arbitrary value to the introspection system. To
         identify a metadata value among others, you can attach a <a href="/docs/reference/foundations/label/" title="`label`"><code>label</code></a> to it and
         query for that label.</p>

docs/i18n/category/layout-en.yaml

@@ -3918,8 +3918,10 @@ children:
       - name: alignment
         details: |-
           <p>Relative to which position in the parent container to place the content.</p>
-          <p>Cannot be <code><span class="typ-key">auto</span></code> if <code>float</code> is <code><span class="typ-key">false</span></code> and must be either
-          <code><span class="typ-key">auto</span></code>, <code>top</code>, or <code>bottom</code> if <code>float</code> is <code><span class="typ-key">true</span></code>.</p>
+          <ul>
+          <li>If <code>float</code> is <code><span class="typ-key">false</span></code>, then this can be any alignment other than <code><span class="typ-key">auto</span></code>.</li>
+          <li>If <code>float</code> is <code><span class="typ-key">true</span></code>, then this must be <code><span class="typ-key">auto</span></code>, <code>top</code>, or <code>bottom</code>.</li>
+          </ul>
           <p>When an axis of the page is <code><span class="typ-key">auto</span></code> sized, all alignments relative to
           that axis will be ignored, instead, the item will be placed in the
           origin of the axis.</p>
@@ -3985,6 +3987,9 @@ children:
             <span class="typ-func">place</span><span class="typ-punct">(</span>center<span class="typ-punct">,</span> dx<span class="typ-punct">:</span> amount <span class="typ-op">-</span> <span class="typ-num">32pt</span><span class="typ-punct">,</span> dy<span class="typ-punct">:</span> amount<span class="typ-punct">)</span><span class="typ-punct">[</span>A<span class="typ-punct">]</span>
           <span class="typ-punct">}</span>
           </code></pre><div class="preview"><img src="/assets/docs/2894bae3ce0defe070261a5d5f61fe40.png" alt="Preview" width="480" height="190"/></div></div>
+          <p>This does not affect the layout of in-flow content.
+          In other words, the placed content is treated as if it
+          were wrapped in a <a href="/docs/reference/layout/move/" title="`move`"><code>move</code></a> element.</p>
         types:
         - relative
         strings: []
@@ -3995,7 +4000,11 @@ children:
         variadic: false
         settable: true
       - name: dy
-        details: <p>The vertical displacement of the placed content.</p>
+        details: |-
+          <p>The vertical displacement of the placed content.</p>
+          <p>This does not affect the layout of in-flow content.
+          In other words, the placed content is treated as if it
+          were wrapped in a <a href="/docs/reference/layout/move/" title="`move`"><code>move</code></a> element.</p>
         example: null
         types:
         - relative

docs/i18n/category/model-en.yaml

@@ -1725,17 +1725,16 @@ children:
           <p>An entry in a footnote list.</p>
           <p>This function is not intended to be called directly. Instead, it is used
           in set and show rules to customize footnote listings.</p>
-          <p><em>Note:</em> Set and show rules for <code>footnote.entry</code> must be defined at the
-          beginning of the document in order to work correctly.
-          See <a href="https://github.com/typst/typst/issues/1348#issuecomment-1566316463">here</a>
-          for more information.</p>
         example: |-
           <div class="previewed-code"><pre><code><span class="typ-key">#</span><span class="typ-key">show</span> footnote<span class="typ-punct">.</span><span class="typ-func">entry</span><span class="typ-punct">:</span> <span class="typ-key">set</span> <span class="typ-func">text</span><span class="typ-punct">(</span>red<span class="typ-punct">)</span>
 
           My footnote listing
           <span class="typ-func">#</span><span class="typ-func">footnote</span><span class="typ-punct">[</span>It&#39;s down here<span class="typ-punct">]</span>
           has red text!
           </code></pre><div class="preview"><img src="/assets/docs/e07bed06d522a25126bd74abd9d30066.png" alt="Preview" width="480" height="190"/></div></div>
+          <p><em>Note:</em> Set and show rules for <code>footnote.entry</code> must be defined at the
+          beginning of the document in order to work correctly. See <a href="https://github.com/typst/typst/issues/1467#issuecomment-1588799440">here</a> for
+          more information.</p>
         self: false
         params:
         - name: note
@@ -2810,7 +2809,7 @@ children:
           <p>The outline's heading will not be numbered by default, but you can
           force it to be with a show-set rule:
           <code><span class="typ-key">show</span> <span class="typ-func">outline</span><span class="typ-punct">:</span> <span class="typ-key">set</span> <span class="typ-func">heading</span><span class="typ-punct">(</span>numbering<span class="typ-punct">:</span> <span class="typ-str">&quot;1.&quot;</span><span class="typ-punct">)</span></code></p>
-        example: <pre></pre>
+        example: null
         types:
         - none
         - auto

docs/i18n/category/text-en.yaml

@@ -719,7 +719,8 @@ children:
         <h2 id="syntax">Syntax</h2>
         <p>This function also has dedicated syntax. You can enclose text in 1 or 3+
         backticks (<code>`</code>) to make it raw. Two backticks produce empty raw text.
-        When you use three or more backticks, you can additionally specify a
+        This works both in markup and code.</p>
+        <p>When you use three or more backticks, you can additionally specify a
         language tag for syntax highlighting directly after the opening backticks.
         Within raw blocks, everything (except for the language tag, if applicable)
         is rendered as is, in particular, there are no escape sequences.</p>
@@ -1738,12 +1739,17 @@ children:
           <p>In the web app, you can see the list of available fonts by clicking on
           the &quot;Ag&quot; button. You can provide additional fonts by uploading <code>.ttf</code>
           or <code>.otf</code> files into your project. They will be discovered
-          automatically.</p>
+          automatically. The priority is: project fonts &gt; server fonts.</p>
           </li>
           <li>
-          <p>Locally, Typst uses your installed system fonts. In addition, you can
-          use the <code>--font-path</code> argument or <code>TYPST_FONT_PATHS</code> environment
-          variable to add directories that should be scanned for fonts.</p>
+          <p>Locally, Typst uses your installed system fonts or embedded fonts in
+          the CLI, which are <code>Linux Libertine</code>, <code>New Computer Modern</code>,
+          <code>New Computer Modern Math</code>, and <code>DejaVu Sans Mono</code>. In addition, you
+          can use the <code>--font-path</code> argument or <code>TYPST_FONT_PATHS</code> environment
+          variable to add directories that should be scanned for fonts. The
+          priority is: <code>--font-paths</code> &gt; system fonts &gt; embedded fonts. Run
+          <code>typst fonts</code> to see the fonts that Typst has discovered on your
+          system.</p>
           </li>
           </ul>
         example: |-

docs/i18n/category/visualize-en.yaml

@@ -1378,8 +1378,8 @@ children:
           component is included.</p>
         example: |-
           <div class="previewed-code"><pre><code><span class="typ-comment">// note that the alpha component is included by default</span>
-          <span class="typ-punct">#</span><span class="typ-punct">(</span><span class="typ-func">rgb</span><span class="typ-punct">(</span><span class="typ-num">40%</span><span class="typ-punct">,</span> <span class="typ-num">60%</span><span class="typ-punct">,</span> <span class="typ-num">80%</span><span class="typ-punct">)</span><span class="typ-punct">.</span><span class="typ-func">components</span><span class="typ-punct">(</span><span class="typ-punct">)</span> <span class="typ-op">==</span> <span class="typ-punct">(</span><span class="typ-num">40%</span><span class="typ-punct">,</span> <span class="typ-num">60%</span><span class="typ-punct">,</span> <span class="typ-num">80%</span><span class="typ-punct">,</span> <span class="typ-num">100%</span><span class="typ-punct">)</span><span class="typ-punct">)</span>
-          </code></pre><div class="preview"><img src="/assets/docs/6256b6a7300a0fc8a2526dd5401230c8.png" alt="Preview" width="480" height="190"/></div></div>
+          <span class="typ-func">#</span><span class="typ-func">rgb</span><span class="typ-punct">(</span><span class="typ-num">40%</span><span class="typ-punct">,</span> <span class="typ-num">60%</span><span class="typ-punct">,</span> <span class="typ-num">80%</span><span class="typ-punct">)</span><span class="typ-punct">.</span><span class="typ-func">components</span><span class="typ-punct">(</span><span class="typ-punct">)</span>
+          </code></pre><div class="preview"><img src="/assets/docs/43a9b4ace8d343e07ec2b841211eace5.png" alt="Preview" width="480" height="190"/></div></div>
         self: true
         params:
         - name: alpha