MkDocs 설치 방법

한승재·2023년 6월 8일

mac 기준


https://docs.conda.io/en/latest/miniconda.html (mac용 Python 3.9(최신) miniconda 설치)
sh Miniconda3-py39_4.9.2-MacOSX-x86_64.sh <-- yes..등 설치

conda create --name python39 python=3.9
conda activate python39

-- 여기부터 설치
brew install pandoc
brew install texlive 
brew install texlive-latex-extra 
brew install texlive-latex-recommended
brew install texlive-xetex

pip install mkdocs
pip install mkdocs-pandoc-plugin
pip install mkdocs-mk2pdf-plugin

pip install mkdocs-material
pip install mkdocs-awesome-pages-plugin
pip install mkdocs-rtd-dropdown

-- brew install mactex (용량커서 x, 아래 tinytex)
curl -sL "https://yihui.org/tinytex/install-bin-unix.sh" | sh
tlmgr install collection-fontsrecommended

-- 한글검색 지원
conda info |grep 'active env location'
->
cp docs/js/lunr.kr.js /위경로/lib/python3.9/site-packages/mkdocs/contrib/search/lunr-language/
cp docs/js/lunr.kr.js /Users/{user_name}/miniconda3/envs/python39/lib/python3.9/site-packages/mkdocs/contrib/search/lunr-language/

--test
cd /tmp
mkdocs new my-project

centos 기준

python 2.7 확인후 설치

sudo yum update # update yum
sudo yum install centos-release-scl # install SCL 
sudo yum install python27 # install Python 2.7

python 2.7 확인후 설치

$ brew install pandoc 
$ brew cask install mactex



$ pip install mkdocs-pandoc

$ cd doc/manual
$ mkdocs2pandoc > /tmp/mydocs.pd
$ mkdocs build
$ pandoc --toc -f markdown+grid_tables+table_captions -o ~/Documents/skt-manual.docx /tmp/mydocs.pd
$ rm -rf site


#pandoc --toc -f markdown+grid_tables+table_captions -o mydocs.pdf mydocs.pd   # Generate PDF
#pandoc --toc -f markdown+grid_tables+table_captions -o mydocs.docx mydocs.pd   # Generate DOCX
#pandoc --toc -f markdown+grid_tables -t epub -o mydocs.epub mydocs.pd         # Generate EPUB


--window--
$ cd doc/manual
$ mkdocs2pandoc > C:\Temp\mydocs.pd
$ mkdocs build
$ pandoc --toc -f markdown+grid_tables+table_captions --reference-doc C:\Temp\sample.docx -o C:\Temp\skt-manual.docx C:\Temp\mydocs.pd
$ rm -rf site
scp -r site/* root@10.10.30.21:/opt/skt-mkdocs/manual/site/
pip install mkdocs-rtd-dropdown
  • 테마변경
theme:
  name: 'rtd-dropdown'

0개의 댓글