|
1 |
| -# gitbook 관리를 위한 markdown 파일 생성 툴 |
| 1 | +# GitBook 관리를 위한 Markdown 파일 생성 툴 |
| 2 | + |
| 3 | +Jupyter Notebook(`.ipynb`) 파일을 Markdown 파일로 변환하고, GitBook 관리에 적합한 형식으로 저장된다. |
2 | 4 |
|
3 | 5 | ## 사용법
|
4 | 6 |
|
5 |
| -```bash |
6 |
| -python mdconverter.py --filename <notebook-file-path> |
7 |
| -``` |
| 7 | +### 1. 단일 파일 변환 |
8 | 8 |
|
9 |
| -**예시** |
| 9 | +```python |
| 10 | +from markdown_generator.mdconverter_class import MultiNdconverter |
10 | 11 |
|
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() |
13 | 17 | ```
|
14 | 18 |
|
15 |
| -개발 중... |
| 19 | +### 2. 디렉토리 내 여러 파일 변환 |
| 20 | + |
| 21 | + |
16 | 22 | ```python
|
| 23 | +import os |
| 24 | +from markdown_generator.mdconverter_class import MultiNdconverter |
| 25 | + |
| 26 | +# 변환할 디렉토리 설정 |
| 27 | +folder_name = "04-Model" |
17 | 28 |
|
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")] |
23 | 31 |
|
| 32 | +# 초기화 및 실행 |
| 33 | +app = MultiNdconverter(filenames=file_list) |
| 34 | +app.css_filename = "../css/styles.css" |
| 35 | +app.post_fix = "-(CEHCK)" # option |
24 | 36 | app.run()
|
25 | 37 | ```
|
| 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