준호씨의 블로그

이번 포스팅에서는 MkDocs를 이용하여 간단하게 위키 형태의 사이트를 GitHub Pages로 만드는 방법을 알아보겠습니다.📌 준비물PythonGitGitHub 계정✅ MkDocs 설치 및 설정하기프로젝트 환경을 설정하는 최적의 방법은 아래와 같습니다.mkdir my-wikicd my-wiki# 원하는 Python 버전 설정 (예시)pyenv local 3.12.2# 가상환경 설정python -m venv .venvsource .venv/bin/activate# MkDocs 설치pip install mkdocs mkdocs-material# MkDocs 프로젝트 생성mkdocs new .✅ GitHub 저장소 연결GitHub에 저장소를 만든 후 연결합니다. 1. GitHub 저장소 만들기https:/..

위 첨자superscript 아래 첨자subscript 위와 같은 위 첨자(superscript)와 아래 첨자(subscript)를 만드는 방법을 알아보겠습니다. Markdown 위첨자superscript 아래첨자subscript Markdown에서는 html 태그인 , 를 사용하면 됩니다. AsciiDoc 위첨자^superscript^ 아래첨자~subscript~ AsciiDoc에서는 위 첨자/아래 첨자 문법을 제공합니다. ^로 감싸면 위 첨자, ~로 감싸면 아래 첨자가 됩니다. 그런데 공백이 들어가면 동작을 안 합니다. 위첨자^띄어 쓰기 안된다^ 이렇게 하면 입력한 그대로 나옵니다. 이럴 땐 HTML을 사용해야 합니다. ++++ 띄어쓰기띄어쓰기 하려면 HTML 사용 ++++ +++testhello w..

조금 (많이?) 늦은 감이 있지만 AsciiDoc이란 게 있다는 것을 알게 되었습니다. MarkDown과 비슷하게 텍스트로 양식이 있는 문서를 작성할 수 있는 문서 작성 문법이라고 보면 됩니다. 아앗... 그런데 역시 대세는 markdown 이군요. asciidoc도 혹시 성장 중인 건 아닐까요? 딱히 아닌 거 같습니다. 끝물을 잘못 잡은 건 아닌지 갑자기 걱정되기 시작합니다. 아아니... 심지어 2013년이 마지막 릴리즈입니다. 아아니... MarkDown은 심지어 2004년이 마지막 릴리즈였군요. AsciiDoc이 좀 더 최신(?) 기법이라고 봐도 되지 않을까 합니다. MarkDown이 이렇게 오래된 것이었다니 새삼 놀랍군요. AsciiDoc에 대해서 글을 쓰고 있지만 사실 저는 아직 AsciiDoc..

마크다운 + 이미지 바로붙기 + 히스토리 저장이 조합만 지원 되어도 꽤 쓸만하지 않을까.