Merge branch 'main' into translate-introspection/query

Author: ultimatile

crates/typst-library/src/introspection/here.rs

@@ -4,32 +4,27 @@ use crate::diag::HintedStrResult;
 use crate::foundations::{func, Context};
 use crate::introspection::Location;
 
-/// Provides the current location in the document.
+/// 文書中における現在のロケーションを提供。
 ///
-/// You can think of `here` as a low-level building block that directly extracts
-/// the current location from the active [context]. Some other functions use it
-/// internally: For instance, `{counter.get()}` is equivalent to
-/// `{counter.at(here())}`.
+/// `here`はアクティブな[コンテキスト]($context)から現在のロケーションを直接取得する低レベルな構成要素と考えることができます。
+/// いくつかの他の関数が内部で使用しています。
+/// 例えば、`{counter.get()}`は`{counter.at(here())}`と等価です。
 ///
-/// Within show rules on [locatable]($location/#locatable) elements, `{here()}`
-/// will match the location of the shown element.
+/// [ロケータブル]($location/#locatable)要素に対するshowルールにおいて、`{here()}`は表示する要素のロケーションにマッチします。
 ///
-/// If you want to display the current page number, refer to the documentation
-/// of the [`counter`] type. While `here` can be used to determine the physical
-/// page number, typically you want the logical page number that may, for
-/// instance, have been reset after a preface.
+/// 現在のページ番号を表示したい場合は、[`counter`]型のドキュメントを参照してください。
+/// `here`は物理的なページ番号を決定できますが、通常は、前書きの後にリセットされるような、論理的なページ番号が必要でしょう。
 ///
-/// # Examples
-/// Determining the current position in the document in combination with the
-/// [`position`]($location.position) method:
+/// # 例
+/// [`position`]($location.position)メソッドと組み合わせて文書中での現在位置を決定します。
 /// ```example
 /// #context [
 ///   I am located at
 ///   #here().position()
 /// ]
 /// ```
 ///
-/// Running a [query] for elements before the current position:
+/// 現在位置より前にある要素に対して[クエリ]($query)を実行します。
 /// ```example
 /// = Introduction
 /// = Background
@@ -42,7 +37,7 @@ use crate::introspection::Location;
 ///
 /// = Conclusion
 /// ```
-/// Refer to the [`selector`] type for more details on before/after selectors.
+/// セレクターのbeforeおよびafterに関する詳細は[`selector`]型のドキュメントを参照してください。
 #[func(contextual)]
 pub fn here(context: Tracked<Context>) -> HintedStrResult<Location> {
     context.location()

crates/typst-library/src/introspection/locate.rs

@@ -5,15 +5,13 @@ use crate::engine::Engine;
 use crate::foundations::{func, Context, LocatableSelector};
 use crate::introspection::Location;
 
-/// Determines the location of an element in the document.
+/// 文書中の要素のロケーションを特定。
 ///
-/// Takes a selector that must match exactly one element and returns that
-/// element's [`location`]. This location can, in particular, be used to
-/// retrieve the physical [`page`]($location.page) number and
-/// [`position`]($location.position) (page, x, y) for that element.
+/// 厳密に1つだけの要素にマッチしなければならないセレクターを受け取り、要素の[`location`]を返します。
+/// このlocationを用いると、特に、物理的な[`page`]($location.page)番号やその要素の[`position`]($location.position)（ページ番号、x座標、y座標）を取得できます。
 ///
-/// # Examples
-/// Locating a specific element:
+/// # 例
+/// 特定の要素のロケーションを特定します。
 /// ```example
 /// #context [
 ///   Introduction is at: \
@@ -26,13 +24,12 @@ use crate::introspection::Location;
 pub fn locate(
     engine: &mut Engine,
     context: Tracked<Context>,
-    /// A selector that should match exactly one element. This element will be
-    /// located.
+    /// 厳密に1つだけの要素にマッチしなければならないセレクター。
+    /// その要素のロケーションが決定されます。
     ///
-    /// Especially useful in combination with
-    /// - [`here`] to locate the current context,
-    /// - a [`location`] retrieved from some queried element via the
-    ///   [`location()`]($content.location) method on content.
+    /// 以下との組み合わせが特に便利です。
+    /// - [`here`]と組み合わせた現在のコンテキストでのロケーションの特定
+    /// - 何らかのクエリで得られた要素からコンテンツの[`location()`]($content.location)メソッドを用いて取得した[`location`]
     selector: LocatableSelector,
 ) -> HintedStrResult<Location> {
     selector.resolve_unique(engine.introspector, context)

crates/typst-library/src/introspection/location.rs

@@ -8,19 +8,17 @@ use crate::foundations::{func, scope, ty, Repr};
 use crate::layout::Position;
 use crate::model::Numbering;
 
-/// Identifies an element in the document.
+/// 文書中の要素の識別。
 ///
-/// A location uniquely identifies an element in the document and lets you
-/// access its absolute position on the pages. You can retrieve the current
-/// location with the [`here`] function and the location of a queried or shown
-/// element with the [`location()`]($content.location) method on content.
+/// locationは文書中の要素を一意に識別し、ページ中での絶対位置へのアクセスを提供します。
+/// [`here`]関数を用いて現在のロケーションを取得可能です。
+/// また、検索したロケーションや表示された要素のロケーションは、コンテンツの[`location()`]($content.location)メソッドを使って取得できます。
 ///
-/// # Locatable elements { #locatable }
-/// Currently, only a subset of element functions is locatable. Aside from
-/// headings and figures, this includes equations, references, quotes and all
-/// elements with an explicit label. As a result, you _can_ query for e.g.
-/// [`strong`] elements, but you will find only those that have an explicit
-/// label attached to them. This limitation will be resolved in the future.
+/// # ロケータブル要素 { #locatable }
+/// 現在、要素関数の一部のみがロケーションを取得可能です。
+/// 見出しや図表の他に、数式、参照、引用、全ての明示的なラベルを持つ要素が該当します。
+/// したがって、例えば[`strong`]要素に対してクエリが実行 _可能_ ですが、見つかるのは明示的にラベルが付けられたもののみです。
+/// この制限は将来的に解消される予定です。
 #[ty(scope)]
 #[derive(Copy, Clone, Eq, PartialEq, Hash)]
 pub struct Location(u128);
@@ -48,16 +46,13 @@ impl Location {
 
 #[scope]
 impl Location {
-    /// Returns the page number for this location.
+    /// このlocationのページ番号を返します。
     ///
-    /// Note that this does not return the value of the [page counter]($counter)
-    /// at this location, but the true page number (starting from one).
+    /// このlocationの[ページカウンター]($counter)の値を返すのではなく、（1始まりの）実際のページ番号を返すことに注意してください。
     ///
-    /// If you want to know the value of the page counter, use
-    /// `{counter(page).at(loc)}` instead.
+    /// ページカウンターの値が知りたい場合は代わりに`{counter(page).at(loc)}`を使用してください。
     ///
-    /// Can be used with [`here`] to retrieve the physical page position
-    /// of the current context:
+    /// [`here`]と組み合わせることで現在のコンテキストにおける実際のページ番号が取得できます。
     /// ```example
     /// #context [
     ///   I am located on
@@ -69,24 +64,20 @@ impl Location {
         engine.introspector.page(self)
     }
 
-    /// Returns a dictionary with the page number and the x, y position for this
-    /// location. The page number starts at one and the coordinates are measured
-    /// from the top-left of the page.
+    /// このlocationのページ番号とx座標とy座標を辞書で返します。
+    /// ページ番号は1始まりで、座標はページの左上から測ります。
     ///
-    /// If you only need the page number, use `page()` instead as it allows
-    /// Typst to skip unnecessary work.
+    /// ページ番号のみに興味がある場合は、代わりに`page()`を使用すると不要な処理を省略できます。
     #[func]
     pub fn position(self, engine: &mut Engine) -> Position {
         engine.introspector.position(self)
     }
 
-    /// Returns the page numbering pattern of the page at this location. This
-    /// can be used when displaying the page counter in order to obtain the
-    /// local numbering. This is useful if you are building custom indices or
-    /// outlines.
+    /// このlocationのページ番号の番号付けパターンを返します。
+    /// これにより、ページカウンターの表示する際に、その位置での番号付けを取得できます。
+    /// これは独自の索引やアウトラインを作成する場合に便利です。
     ///
-    /// If the page numbering is set to `{none}` at that location, this function
-    /// returns `{none}`.
+    /// そのロケーションのページの番号付けが`{none}`に設定されていた場合、`{none}`を返します。
     #[func]
     pub fn page_numbering(self, engine: &mut Engine) -> Option<Numbering> {
         engine.introspector.page_numbering(self).cloned()

docs/glossary.md

@@ -25,3 +25,5 @@ description: |
 | table | 表 | データや情報を整理して表示する要素 |
 | supplement | 補足語 | [参照]($ref)されるものの種類を指す文字列、「図1」の「図」など |
 | numbering | 番号付け | [見出し]($heading/#parameters-numbering)や[図表]($figure/#parameters-numbering)、[番号付きリスト]($enum/#parameters-numbering)などの番号の書式を定義する方法 |
+| location | ロケーション | [ロケーション]($location)を参照 |
+| locatable | ロケータブル | [ロケータブル要素]($location/#locatable)を参照 |

website/translation-status.json

@@ -145,9 +145,9 @@
 	"/docs/reference/visualize/tiling/": "untranslated",
 	"/docs/reference/introspection/": "translated",
 	"/docs/reference/introspection/counter/": "translated",
-	"/docs/reference/introspection/here/": "untranslated",
-	"/docs/reference/introspection/locate/": "untranslated",
-	"/docs/reference/introspection/location/": "untranslated",
+	"/docs/reference/introspection/here/": "translated",
+	"/docs/reference/introspection/locate/": "translated",
+	"/docs/reference/introspection/location/": "translated",
 	"/docs/reference/introspection/metadata/": "translated",
 	"/docs/reference/introspection/query/": "translated",
 	"/docs/reference/introspection/state/": "untranslated",