Skip to content

Commit dfb6e8b

Browse files
committed
feat: rst to markdown
1 parent 2bff3e9 commit dfb6e8b

File tree

12 files changed

+235
-277
lines changed

12 files changed

+235
-277
lines changed

docs/source/conf.py

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -23,6 +23,7 @@
2323
"sphinx.ext.autodoc",
2424
"sphinx.ext.napoleon",
2525
"sphinx.ext.autosummary",
26+
"sphinx_copybutton",
2627
"myst_parser",
2728
]
2829

Lines changed: 29 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,29 @@
1+
# インストール
2+
3+
このセクションでは、パッケージのインストール方法について説明します。
4+
5+
6+
## 前提条件
7+
8+
インストールする前に、以下の前提条件を確認してください:
9+
10+
- Python 3.12 以上
11+
- pip
12+
13+
## パッケージのインストール
14+
15+
パッケージをインストールするには、次のコマンドを実行します:
16+
17+
```bash
18+
pip install adf_core_python
19+
```
20+
21+
## インストールの確認
22+
23+
インストールを確認するには、次のコマンドを実行します:
24+
25+
```bash
26+
python -c "import adf_core_python; print(adf_core_python.__version__)"
27+
```
28+
29+
パッケージが正しくインストールされている場合、パッケージのバージョン番号が表示されます。

docs/source/installation/installation.rst

Lines changed: 0 additions & 43 deletions
This file was deleted.
Lines changed: 62 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,62 @@
1+
# クイックスタート
2+
3+
## 前提条件
4+
5+
インストールする前に、以下の前提条件を確認してください:
6+
7+
- Python 3.12 以上
8+
- pip
9+
10+
## パッケージのインストール
11+
12+
パッケージをインストールするには、次のコマンドを実行します:
13+
14+
```bash
15+
pip install adf_core_python
16+
```
17+
18+
## 新規エージェントの作成
19+
20+
新規エージェントを作成するには、次のコマンドを実行します:
21+
22+
```bash
23+
adf-core-python
24+
```
25+
26+
実行すると、下記のような対話形式のプロンプトが表示されます:
27+
28+
```bash
29+
Your agent team name: my-agent
30+
Creating a new agent team with name: my-agent
31+
```
32+
33+
入力後、下記のようなエージェントのテンプレートがカレントディレクトリに作成されます。
34+
35+
```bash
36+
.
37+
├── config
38+
│ ├── development.json
39+
│ ├── launcher.yaml
40+
│ └── module.yaml
41+
├── main.py
42+
└── src
43+
└── my-agent
44+
├── __init__.py
45+
└── module
46+
├── __init__.py
47+
└── complex
48+
├── __init__.py
49+
├── sample_human_detector.py
50+
├── sample_road_detector.py
51+
└── sample_search.py
52+
```
53+
54+
## エージェントを実行する
55+
56+
エージェントを実行するには、シミュレーションサーバーを起動し、次のコマンドを実行します:
57+
58+
```bash
59+
python main.py
60+
```
61+
62+
エージェントの実行が開始され、シミュレーションサーバーとの通信が開始されます。

docs/source/quickstart/quickstart.rst

Lines changed: 0 additions & 70 deletions
This file was deleted.

docs/source/usage/agent/agent.md

Lines changed: 49 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,49 @@
1+
# エージェントの作成
2+
3+
このセクションでは、`adf-core-python` ライブラリの使用方法の概要を提供します。
4+
5+
## 新規エージェントの作成
6+
7+
新規エージェントを作成するには、次のコマンドを実行します:
8+
9+
```bash
10+
adf-core-python
11+
```
12+
13+
実行すると、下記のような対話形式のプロンプトが表示されます:
14+
15+
```bash
16+
Your agent team name: my-agent
17+
Creating a new agent team with name: my-agent
18+
```
19+
20+
入力後、下記のようなエージェントのテンプレートがカレントディレクトリに作成されます。
21+
22+
```bash
23+
.
24+
├── config
25+
│ ├── development.json
26+
│ ├── launcher.yaml
27+
│ └── module.yaml
28+
├── main.py
29+
└── src
30+
└── my-agent
31+
├── __init__.py
32+
└── module
33+
├── __init__.py
34+
└── complex
35+
├── __init__.py
36+
├── sample_human_detector.py
37+
├── sample_road_detector.py
38+
└── sample_search.py
39+
```
40+
41+
## エージェントを実行する
42+
43+
エージェントを実行するには、シミュレーションサーバーを起動し、次のコマンドを実行します:
44+
45+
```bash
46+
python main.py
47+
```
48+
49+
エージェントの実行が開始され、シミュレーションサーバーとの通信が開始されます。

docs/source/usage/agent/agent.rst

Lines changed: 0 additions & 59 deletions
This file was deleted.
Lines changed: 6 additions & 10 deletions
Original file line numberDiff line numberDiff line change
@@ -1,24 +1,20 @@
1-
コンフィグについて
2-
=================
1+
# コンフィグについて
32

4-
コンフィグについての説明
5-
----------------
3+
## コンフィグについての説明
4+
5+
### launcher.yaml
66

7-
launcher.yaml
8-
^^^^^^^^^^^^^
97
launcher.yaml は、エージェントの起動時に読み込まれる設定ファイルです。
108
シミュレーションサーバーの指定や読み込むモジュールが記述されたファイルの指定などが記述されています。
119

10+
### module.yaml
1211

13-
module.yaml
14-
^^^^^^^^^^^
1512
module.yaml は、エージェントが読み込むモジュールの設定ファイルです。
1613
読み込むモジュールのパスなどが記述されています。
1714
パスを指定する際は、プロジェクトのmain.pyからの相対パスで指定してください。
1815

16+
### development.json
1917

20-
development.json
21-
^^^^^^^^^^^^^^^^^
2218
development.json は、開発時に使用する設定ファイルです。
2319
エージェントの開発時に外部から値を取得する際に使用します。
2420
そのため、競技時には使用することができません。
File renamed without changes.

0 commit comments

Comments
 (0)