Merge branch 'main' into translate-introspection/location

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)

website/translation-status.json

@@ -145,8 +145,8 @@
 	"/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/here/": "translated",
+	"/docs/reference/introspection/locate/": "translated",
 	"/docs/reference/introspection/location/": "translated",
 	"/docs/reference/introspection/metadata/": "translated",
 	"/docs/reference/introspection/query/": "untranslated",