Skip to content

Commit

Permalink
Updated ja documents to align with cfc7b0d (#1186)
Browse files Browse the repository at this point in the history
* translate the latest README.md into Japanese

* Updated sidebar/ja.ts to align with the latest version

* Updated sidebar/js.ts path to align with the latest ja version

* del useless code

* add getting_stated.m

* updated i18n-meta.json
  • Loading branch information
YukiOnodera authored Jan 11, 2024
1 parent 832e2e4 commit 6e3d4ed
Show file tree
Hide file tree
Showing 4 changed files with 171 additions and 39 deletions.
110 changes: 96 additions & 14 deletions .vuepress/configs/sidebar/ja.ts
Original file line number Diff line number Diff line change
@@ -1,24 +1,106 @@
import type { SidebarConfig } from '@vuepress/theme-default';
// import { commandCategories } from './command_categories';

export const sidebarJa: SidebarConfig = {
'/ja/book/': [
{
text: 'Nu Book',
text: 'はじめに',
link: '/ja/book/README.md',
collapsible: false,
},
{
text: 'Getting Started',
link: '/ja/book/getting_started.md',
collapsible: false,
children: [
'/ja/book/installation.md',
'/book/default_shell.md',
'/ja/book/quick_tour.md',
'/ja/book/moving_around.md',
'/book/thinking_in_nu.md',
'/book/cheat_sheet.md',
],
},
{
text: 'Nu 基礎編',
link: '/ja/book/nu_fundamentals.md',
collapsible: false,
children: [
'/ja/book/types_of_data.md',
'/ja/book/loading_data.md',
'/ja/book/pipelines.md',
'/book/working_with_strings.md',
'/book/working_with_lists.md',
'/ja/book/working_with_tables.md',
],
},
{
text: 'Programming in Nu',
link: '/ja/book/programming_in_nu.md',
collapsible: false,
children: [
'/book/custom_commands.md',
'/ja/book/aliases.md',
'/book/operators.md',
'/book/variables_and_subexpressions.md',
'/book/scripts.md',
'/book/modules.md',
'/book/overlays.md',
'/book/command_signature.md',
'/book/testing.md',
'/book/style_guide.md',
],
},
{
text: 'シェルとしての Nu',
link: '/ja/book/nu_as_a_shell.md',
collapsible: false,
children: [
'/ja/book/configuration.md',
'/ja/book/environment.md',
'/book/stdout_stderr_exit_codes.md',
'/ja/book/escaping.md',
'/book/3rdpartyprompts.md',
'/ja/book/shells_in_shells.md',
'/book/line_editor.md',
'/book/externs.md',
'/book/custom_completions.md',
'/book/coloring_and_theming.md',
'/book/hooks.md',
'/book/background_task.md',
],
},
{
text: 'Nu への移行',
link: '/ja/book/coming_to_nu.md',
collapsible: false,
children: [
'/ja/book/coming_from_bash.md',
'/book/coming_from_cmd.md',
'/ja/book/nushell_map.md',
'/ja/book/nushell_map_imperative.md',
'/ja/book/nushell_map_functional.md',
'/ja/book/nushell_operator_map.md',
],
},
{
text: 'Design Notes',
link: '/ja/book/design_notes.md',
collapsible: false,
children: ['/book/how_nushell_code_gets_run.md'],
},
{
text: '(Not So) Advanced',
link: '/ja/book/advanced.md',
collapsible: false,
children: [
'installation',
'introduction',
'moving_around',
'types_of_data',
'loading_data',
'working_with_tables',
'pipeline',
'configuration',
'metadata',
'shells_in_shells',
'escaping',
'plugins',
'/book/command_reference.md',
'/book/standard_library.md',
'/book/dataframes.md',
'/ja/book/metadata.md',
'/book/creating_errors.md',
'/book/parallelism.md',
'/ja/book/plugins.md',
'/book/explore.md',
],
},
],
Expand Down
4 changes: 2 additions & 2 deletions i18n-meta.json
Original file line number Diff line number Diff line change
Expand Up @@ -15,7 +15,7 @@
"zh-CN": "fa90895307@hustcer",
"de": "-",
"tr": "-",
"ja": "-",
"ja": "cfc7b0d@YukiOnodera",
"es": "-",
"pt-BR": "-"
},
Expand Down Expand Up @@ -215,7 +215,7 @@
"zh-CN": "-",
"de": "c39efa00@petrisch",
"tr": "-",
"ja": "-",
"ja": "cfc7b0d@YukiOnodera",
"es": "-",
"pt-BR": "-"
},
Expand Down
87 changes: 64 additions & 23 deletions ja/book/README.md
Original file line number Diff line number Diff line change
@@ -1,23 +1,64 @@
# 目次

- [インストール](installation.md) - nushell のインストール
- [はじめに](introduction.md) - nushell をはじめよう
- [ファイルシステムの操作](moving_around.md) - nushell からファイルシステムを扱おう
- [データ型](types_of_data.md) - nushell のデータ型
- [データの読み込み](loading_data.md) - データの読み込みとその利用方法
- [テーブル](working_with_tables.md) - テーブルを利用してみよう
- [パイプライン](pipeline.md) - パイプラインの仕組み
- [設定](configuration.md) - nushell の設定方法
- [エイリアス](aliases.md) - コードブロックに名前をつけよう
- [Math](math.md) - nushell で計算する
- [環境変数](environment.md) - 環境変数の設定
- [メタデータ](metadata.md) - nushell におけるメタデータについて
- [シェル](shells_in_shells.md) - 複数の場所で作業しよう
- [コマンドのエスケープ](escaping.md) - Nu コマンドと同じ名前のコマンドを実行するには
- [プラグイン](plugins.md) - プラグインを利用して nushell を拡張する
- [Bash から来た人向け](coming_from_bash.md) - bash から nushell に来た人向けガイド
- [shells/DSL と nushell の対応表](nushell_map.md) - nushell と SQL, Linq, PowerShell, Bash との対応表。コントリビューション歓迎。
- [命令形言語と nushell の対応表](nushell_map_imperative.md) - nushell と Python, Kotlin, C++, C#, Rust との対応表。コントリビューション歓迎。
- [関数型言語と nushell の対応表](nushell_map_functional.md) - nushell と Clojure, Tablecloth (Ocaml / Elm), Haskell との対応表。コントリビューション歓迎。
- [Nushell 演算子対応表](nushell_operator_map.md) - 演算子の対応表。
- [Command Reference](command_reference.md) - A list of all Nushell's commands.
# はじめに

こんにちは、Nushellプロジェクトへようこそ。

このプロジェクトの目的は、Unixシェルの哲学を採用し、シンプルなコマンドをパイプでつなぐアイデアを現代の開発スタイルに適応させることです。
したがって、Nushell はシェルでもプログラミング言語でもなく、豊かなプログラミング言語とフル機能のシェルを一つのパッケージに統合したものなのです。

Nuは様々な馴染みのある要素からヒントを得ています:伝統的なシェル(例えばbash)、オブジェクトベースのシェル(PowerShellなど)、徐々に型付けされる言語(TypeScriptなど)、関数型プログラミング、システムプログラミングなど。

しかし、万能であるよりも、Nuはいくつかのことを上手に行うことに重点を置いています:

- モダンで柔軟なクロスプラットフォームシェルであること
- データの構造を利用して問題を解決する、モダンなプログラミング言語として機能すること
- 明確なエラーメッセージとクリーンなIDEサポートを提供すること

## この本について

この本はいくつかの章に分けられ、さらにセクション毎に分割されています。
章のヘッダーをクリックすると、その章についての詳細情報が得られます。

- [Getting Started](getting_started.md) では、Nushellのインストール方法と基本的な使い方を学びます。また、Nushellが典型的なシェル(例えばbash)と異なる設計原則についても説明します。
- [Nu Fundamentals](nu_fundamentals.md) では、Nushell言語の基本概念について説明します。
- [Programming in Nu](programming_in_nu.md) では、言語の機能をより深く掘り下げ、コードの組織化と構造化のさまざまな方法を紹介します。
- [Nu as a Shell](nu_as_a_shell.md)はシェル機能に焦点を当て、特に設定と環境について詳しく説明します。
- [Coming to Nu](coming_to_nu.md)は、他のシェルや言語から移行するユーザーに迅速なスタートを提供することを目的としています。
- [Design Notes](design_notes.md)では、Nushellの設計上の選択について詳細な説明があります。
- [(Not So) Advanced](advanced.md)には、少し高度なトピックが含まれています(それほど高度ではないので、ぜひチェックしてください!)。

## Nushellの全て

Nushellプロジェクトは、複数の異なるリポジトリやサブプロジェクトで構成されています。[our organization on GitHub](https://github.com/nushell)でそれらをすべて見つけることができます。

- メインのNushellリポジトリは[こちら](https://github.com/nushell/nushell)です。これは複数のクレートに分けられており、ご希望であれば独自のプロジェクトで独立したライブラリとして使用できます。
- 当社の[nushell.sh](https://github.com/nushell/nushell.github.io)ページとこの本のリポジトリは[こちら](https://github.com/nushell/nushell.github.io)です。
- Nushellは独自のラインエディタを持っており、[そのためのリポジトリ](https://github.com/nushell/reedline)があります。
- [`nu_scripts`](https://github.com/nushell/nu_scripts)は、パッケージマネージャーができるまでの間、他のユーザーとスクリプトやモジュールを共有する場所です。
- [Nana](https://github.com/nushell/nana) は、Nushellのグラフィカルユーザーインターフェースを探求する実験的な取り組みです。
- [Awesome Nu](https://github.com/nushell/awesome-nu) には、Nushellエコシステムで動作するツールのリストが含まれています:プラグイン、スクリプト、エディタ拡張、サードパーティの統合など。
- [Nu Showcase](https://github.com/nushell/showcase) は、Nushellに関する作品を共有する場所です。ブログ、アートワーク、その他。
- [Request for Comment (RFC)](https://github.com/nushell/rfcs) は、大きな設計変更を提案し議論するための場所として機能します。現在はあまり活用されていませんが、1.0に近づくにつれて、より多く使用されることを期待しています。

## 貢献

私たちは貢献を歓迎します!
[ご覧の通り](#the-many-parts-of-nushell)、貢献する場所はたくさんあります。
ほとんどのリポジトリには、貢献を始めるのに役立つヒントと詳細が含まれているCONTRIBUTING.mdファイルがあります。(もしなければ、修正を提案することも検討してください!)。

Nushell自体はRustで書かれています。
しかし、Rustプログラマーでなくても助けることができます。
Web開発を知っている場合は、このウェブサイトやNanaプロジェクトの改善に貢献できます。
Dataframesはあなたのデータ処理の専門知識を活用できます。

もし、クールなスクリプトやプラグインを書いたり、Nushellをどこかに統合したりした場合、nu_scriptsやAwesome Nuへの貢献を歓迎します。
バグを発見し、それに対する再現ステップを提供し、GitHubのイシューとして報告することも貴重な助けとなります。Nushellを使用するだけでも、Nushellに貢献していることになります!

Nushellは急速に進化しているため、この本は常に更新が必要です。
この本への貢献には、Markdownに精通していること以外に特別なスキルは必要ありません。
さらに、あなたの言語での部分的な翻訳もできます。

## コミュニティ

Nushellについて何か話し合う主な場所は、私たちの[Discord](https://discord.com/invite/NtAbbGn)です。
ニュースやアップデートについては、[Twitter](https://twitter.com/nu_shell) でフォローすることもできます。
最後に、GitHubのディスカッションを使用するか、GitHubのイシューを提出することもできます。
9 changes: 9 additions & 0 deletions ja/book/getting_started.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,9 @@
# はじめに

さあ、始めましょう! 🐘

まず最初に、Nushellを使用するためには、[インストールする](installation.md)必要があります。

次のセクションでは、Nushellの[簡単な例によるツアー](quick_tour.md)(Nushell内でのヘルプの取得方法を含む)を提供し、ファイルシステムの[移動方法](moving_around.md)を示します。

最後に、Nushellは一般的なシェルや動的スクリプト言語とはかなり異なる設計決定を採用しているため、これらのコンセプトを説明する[Thinking in Nu](thinking_in_nu.md)を確認してください。

0 comments on commit 6e3d4ed

Please sign in to comment.