Skip to content

Commit 9df8dbd

Browse files
Update README.md
version 1.0.0
1 parent ae8d1ac commit 9df8dbd

File tree

1 file changed

+35
-13
lines changed

1 file changed

+35
-13
lines changed

README.md

Lines changed: 35 additions & 13 deletions
Original file line numberDiff line numberDiff line change
@@ -1,25 +1,47 @@
1-
# gitbook 관리를 위한 markdown 파일 생성 툴
1+
# GitBook 관리를 위한 Markdown 파일 생성 툴
2+
3+
Jupyter Notebook(`.ipynb`) 파일을 Markdown 파일로 변환하고, GitBook 관리에 적합한 형식으로 저장된다.
24

35
## 사용법
46

5-
```bash
6-
python mdconverter.py --filename <notebook-file-path>
7-
```
7+
### 1. 단일 파일 변환
88

9-
**예시**
9+
```python
10+
from markdown_generator.mdconverter_class import MultiNdconverter
1011

11-
```bash
12-
python mdconverter.py --filename sample/05-GoogleGenerativeAI.ipynb
12+
file_list = ['04-Model\\06-GoogleGenerativeAI.ipynb'] # 리스트 형식으로 파일 경로
13+
app = MultiNdconverter(filenames=file_list)
14+
app.css_filename = "../css/styles.css" # css 파일 설정
15+
app.post_fix = "-(CEHCK)" # option
16+
app.run()
1317
```
1418

15-
개발 중...
19+
### 2. 디렉토리 내 여러 파일 변환
20+
21+
1622
```python
23+
import os
24+
from markdown_generator.mdconverter_class import MultiNdconverter
25+
26+
# 변환할 디렉토리 설정
27+
folder_name = "04-Model"
1728

18-
from mdconverter.mdconverter_class import Mdconverter
19-
app = Mdconverter()
20-
app.filename = "sample/05-GoogleGenerativeAI.ipynb"
21-
app.output_filename = 'sample/New-05-GoogleGenerativeAI.md'
22-
app.css_filename = "css/styles.css"
29+
# 디렉토리 내 모든 `.ipynb` 파일 경로 리스트 생성
30+
file_list = [os.path.join(folder_name, f) for f in os.listdir(folder_name) if f.endswith(".ipynb")]
2331

32+
# 초기화 및 실행
33+
app = MultiNdconverter(filenames=file_list)
34+
app.css_filename = "../css/styles.css"
35+
app.post_fix = "-(CEHCK)" # option
2436
app.run()
2537
```
38+
39+
### 주요 파라미터
40+
- `filenames`: 변환할 Notebook 파일들의 경로 리스트
41+
- `css_filename`: Markdown 파일에 적용할 CSS 파일 경로
42+
- `post_fix`: 저장 파일명의 후위에 추가되는 명칭(기본값 : "-(NEW)")
43+
- `ndconverter_script`: 최종 결과물 보관
44+
45+
### 결과물
46+
47+
결과물은 `docs` 폴더에 생성된다.

0 commit comments

Comments
 (0)