[docs] READMEの更新
Browse files- はじめにセクションを追加し、前提条件とインストール手順を説明
- 使い方セクションを追加し、アプリケーションの基本的な使用方法を説明
- 設定セクションを追加し、.CodeLumiaignoreファイルについて説明
- プロジェクト構造セクションを追加し、プロジェクトのディレクトリ構造を示す
- コントリビューションセクションを追加し、コントリビューションへの参加方法を説明
- ライセンスセクションを追加し、プロジェクトのライセンスについて言及
README.md
CHANGED
@@ -24,3 +24,72 @@ license: mit
|
|
24 |
|
25 |
</p>
|
26 |
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
24 |
|
25 |
</p>
|
26 |
|
27 |
+
|
28 |
+
## 🚀 はじめに
|
29 |
+
|
30 |
+
### 前提条件
|
31 |
+
|
32 |
+
- Docker
|
33 |
+
- Docker Compose
|
34 |
+
|
35 |
+
### インストール
|
36 |
+
|
37 |
+
1. リポジトリをクローンします:
|
38 |
+
```bash
|
39 |
+
git clone https://github.com/Sunwood-ai-labs/CodeLumia.git
|
40 |
+
cd CodeLumia
|
41 |
+
```
|
42 |
+
|
43 |
+
2. Dockerコンテナをビルドして実行します:
|
44 |
+
```bash
|
45 |
+
docker-compose up --build
|
46 |
+
```
|
47 |
+
|
48 |
+
3. ブラウザで `http://localhost:8501` にアクセスしてアプリケーションを開きます。
|
49 |
+
|
50 |
+
## 📖 使い方
|
51 |
+
|
52 |
+
1. 分析したいGitHubリポジトリのURLをテキスト入力フィールドに入力します。
|
53 |
+
2. アプリケーションがリポジトリをクローンし、ファイルを処理して、マークダウンのドキュメントファイルを生成します。
|
54 |
+
3. 生成されたドキュメントがStreamlitアプリに表示されます。
|
55 |
+
4. "Download Markdown File"リンクをクリックして、マークダウンファイルをダウンロードできます。
|
56 |
+
|
57 |
+
>[!TIP]
|
58 |
+
>Full Textのところからクリップボードにコピーすることもできます
|
59 |
+
|
60 |
+
|
61 |
+
## 🔧 設定
|
62 |
+
|
63 |
+
- `.CodeLumiaignore`ファイルには、ドキュメント生成プロセス中に無視する特定のファイルとディレクトリのパターンが含まれています。これらのパターンは、Streamlitアプリのサイドバーで編集できます。
|
64 |
+
|
65 |
+
## 📂 プロジェクト構造
|
66 |
+
|
67 |
+
```
|
68 |
+
CodeLumia/
|
69 |
+
├─ .github/
|
70 |
+
│ └─ workflows/
|
71 |
+
│ └─ run.yaml
|
72 |
+
├─ docs/
|
73 |
+
│ ├─ language_map.json
|
74 |
+
│ ├─ page_front.md
|
75 |
+
│ └─ SourceSageDocs.md
|
76 |
+
├─ modules/
|
77 |
+
│ ├─ file_operations.py
|
78 |
+
│ ├─ git_operations.py
|
79 |
+
│ └─ markdown_operations.py
|
80 |
+
├─ app.py
|
81 |
+
├─ CodeLumia.md
|
82 |
+
├─ docker-compose.yml
|
83 |
+
├─ Dockerfile
|
84 |
+
├─ README.md
|
85 |
+
└─ requirements.txt
|
86 |
+
```
|
87 |
+
|
88 |
+
## 🤝 コントリビューション
|
89 |
+
|
90 |
+
コントリビューションは大歓迎です!問題を見つけたり、改善のための提案がある場合は、issueを開くかプルリクエストを送ってください。
|
91 |
+
|
92 |
+
## 📄 ライセンス
|
93 |
+
|
94 |
+
このプロジェクトは[MITライセンス](LICENSE)の下で公開されています。
|
95 |
+
```
|