Tricentis Testim ユーザー制作日本語翻訳ドキュメント

Tricentis Testim の公式英語ドキュメントを日本語に翻訳し、原文の更新に継続して追従するユーザー制作プロジェクトです。 Tricentis または Testim が提供する公式日本語版ではありません。

🚀 プロジェクト構成

/
├── public/              # 静的ファイル（favicon など）
├── docs/                # 運用・翻訳・パリティ維持のドキュメント
├── scripts/
│   └── python/          # 同期・検出・保守用 Python tooling
├── src/
│   ├── components/      # 再利用可能なコンポーネント
│   │   ├── navigation/  # ナビゲーション関連
│   │   └── search/      # 検索機能
│   ├── content/
│   │   └── docs/        # Markdown ドキュメント本体
│   ├── layouts/         # ページレイアウト
│   ├── lib/             # ユーティリティ関数
│   ├── pages/           # ルーティング
│   ├── styles/          # グローバル CSS
│   └── types/           # TypeScript 型定義
├── src/content.config.ts # Content Collections 定義
├── astro.config.mjs     # Astro 設定
└── package.json

🛠️ 技術スタック

• フレームワーク: Astro 7 - 高速な静的サイト生成（Content Layer API、Built-in Fonts API）
• スタイリング: Tailwind CSS v4 - ユーティリティファーストCSS
• コンテンツ管理: Markdown (.md) - シンプルで書きやすい
• 検索機能: MiniSearch - クライアントサイド全文検索
• UIコンポーネント: React - インタラクティブな検索UI
• Markdownプラグイン:
  • remark-gfm - GitHub Flavored Markdown（テーブル、タスクリスト、脚注など）
  • remark-directive + @microflash/remark-callout-directives - 情報パネル（:::tip, :::warning など）
  • rehype-autolink-headings - 見出しへの自動リンク
• 型安全性: TypeScript
• 運用ツール: Python 3.14.4 + uv - 原文同期、パリティ確認、正規化、レポート生成

📦 セットアップ

前提条件

• Node.js 22.12 以上、25 未満（package.json の engines は >=22.12.0 <25）
• npm
• Python 3.14.4 と uv（npm run lint、原文同期、パリティ確認に必要）

インストール

# Node.js 依存関係のインストール
npm ci

# Python tooling の依存関係
cd scripts/python
uv sync --locked --all-extras
cd ../..

# 開発サーバーの起動（http://localhost:4321）
npm run dev

# 本番ビルド
npm run build

# ビルド結果のプレビュー
npm run preview

📝 ドキュメントの追加方法

1. src/content/docs/ に新しい .md ファイルを作成
2. frontmatter に必要な情報を記入：

---
title: 'ページタイトル'
description: 'ページの説明文'
category: 'カテゴリ名'
order: 10
updated: 'YYYY-MM-DD' # 英語原文の更新日に合わせる
sourceUrl: 'https://docs.tricentis.com/testim/content/{en-path}.htm' # 英語原文 URL のパスに合わせる（フォルダー階層はページにより異なる）
keywords:
  - keyword1
  - keyword2
---

1. Markdown でコンテンツを執筆
2. 開発サーバーで確認後、コミット

🎨 デザイン方針

• Tricentis Testim 公式ドキュメントのレイアウトを踏襲
• 日本語フォントは Noto Sans JP を使用（Astro Fonts API で自動管理）
• コードブロックは GitHub Dark Dimmed テーマでシンタックスハイライト
• レスポンシブデザイン対応（モバイル・タブレット・デスクトップ）

📚 執筆機能

Markdown (.md) ファイルで以下の拡張機能が利用できます：

• 情報パネル（Callout）: :::tip, :::warning, :::caution, :::danger, :::note, :::info
• コードブロックタイトル: ```javascript title="example.js"
• GitHub Flavored Markdown: テーブル、タスクリスト、脚注、取り消し線
• 見出しへの自動リンク: すべての見出しにアンカーリンクが自動付与

📖 執筆者向けガイド

新しく記事を書く方・編集する方へ:

• 📝 WRITING_GUIDE.md - Markdown の書き方から拡張機能まで、すべて解説

  • Markdown vs MDX の選び方
  • 情報パネル、コードブロックの使い方
  • ベストプラクティスとFAQ
  • 執筆フロー

• 🎨 執筆機能リファレンス - 実装例が豊富なリファレンス

  • すべての機能の詳しい使用例
  • callout・コードブロック・テーブルなど全機能の記述例

• 🌐 TRANSLATION_GUIDE.md - 公式ドキュメントからの翻訳手順

詳細は WRITING_GUIDE.md を参照してください。

🔍 検索機能

• MiniSearch による日本語対応の全文検索
• タイトル、説明文、キーワード、見出しテキストを検索対象に含む
• 部分一致検索とファジー検索に対応
• ⌘K（Mac）または Ctrl+K（Windows/Linux）でクイック起動
• キーボードナビゲーション（↑↓で移動、Enterで選択）

検索機能の特徴：

• リアルタイム検索（入力と同時に結果を表示）
• カテゴリ表示で情報整理
• レスポンシブなモーダルUI
• アクセシブルなキーボード操作

関連ドキュメント

• scripts/README.md - スクリプトの詳しい使い方
• SYSTEM_SPEC.md - Python tooling の現行 gate と環境契約
• DOCS_DATE_TRACKING.md - スナップショット変更検知の仕様
• OPS_DESIGN.md - 運用設計・レビュー手順

📖 利用リソース / クレジット

本プロジェクトでは、一部の機能やプロンプト構成に以下のリソースを利用・参考にしています。

• Empirical Prompt Tuning (from mizchi/skills)
  • Licensed under the MIT License

🏆 ライセンス

このプロジェクトのソースコードは MIT License の下で公開されています。

🤝 コントリビューション

誤訳の修正や追加ドキュメントの提案は Issue または Pull Request でお願いします。

🔗 関連リンク

• Tricentis Testim 公式製品ページ
• Tricentis Testim 公式ドキュメント
• Tricentis Testim 公式 Changelog

---

免責事項: 本プロジェクトはユーザーが制作・運営する非公式翻訳です。Tricentis および Testim とは提携していません。正確性や最新性が重要な場合は、上記の公式英語ドキュメントを確認してください。