코딩일지(2024-05-30)

스핑크스 작업을 이어가다…

이제 곧 있으면 기말고사인데,,, 일단은 이 작업을 좀 이어가자.. 5월8일 진행했던, 코딩일지를 이어서 진행하는 것이다.

저번에 테마선택을 못했는데 이번에 요 블로그(링크)를 참고하여, 테마선택후 작업을 이어가려고 한다.

테마, sphinx_rtf_theme를 선택하다.

source/config.py를 열어서 다음과 같이 편집해주었다.

# -- Options for HTML output -------------------------------------------------
# https://www.sphinx-doc.org/en/master/usage/configuration.html#options-for-html-output

html_theme = 'sphinx_rtd_theme'

그리고 cmd창에서 다음과 같이 빌드를 하고 다시 html문서를 열어주었다.

make html
start ./build/html/index.html

그랬더니 다음과 같이 테마가 적용된 것을 확인할 수 있었다.

파비콘을 넣어주다.

예전에 깃허브 블로그 만들때 제작했더 파비콘을 그냥 여기다가도 넣을라 칸다.

(참고로 위와 같이 폴더구조를 파악할때 폴더하위의 파일명까지 확인하고 싶다면 다음과 같이 명령어를 처주어야 한다 카더라.)

tree source /f

result>

위 경로에 넣어주고 나서, conf.py파일을 열어서 다음을 추가해주었다.

html_favicon='favicon.ico'

그리고 다시 빌드하고 문서를 열어주었다.

성공적으로 파비콘이 적용된 것을 확인할 수 있었다.

목차(ToC)를 만들어주다.

블로그에 나와 있는 내용을 참고하여 내가 구상해놓았던 목차를 구축해보았다. 내가 구상한 목차는 한동석 교수님 연구실과 한양대 자동차공학부 어느 연구실의 웹사이트를 참고한 목차구성도이다.

이후 아래와 같이 대문용 마크다운 파일을 하나씩 심어주었다.

그다음 source/index.rst에 들어가서, 다음과 같이 수정해주었다.

Welcome to rx004's documentation!
=================================
.. toctree::
   :maxdepth: 2
   :caption: TechTalk:

   TeckTalk/tecktalk.md

.. toctree::
   :maxdepth: 2
   :caption: Projects:

   Projects/projects.md

.. toctree::
   :maxdepth: 2
   :caption: Photo:

   Photo/photo.md

.. toctree::
   :maxdepth: 2
   :caption: News:

   News/news.md

.. toctree::
   :maxdepth: 2
   :caption: Members:

   Members/members.md

.. toctree::
   :maxdepth: 2
   :caption: Link:

   Link/link.md

.. toctree::
   :maxdepth: 2
   :caption: Home:

   Home/home.md
==================

* :ref:`genindex`
* :ref:`modindex`
* :ref:`search`

그리고 빌드(make html)를 시도했는데,,

예상보다 제대로 안되었다. 아마 어딘가에서 경로참조가 실패한거 같긴한디…

오늘은 여기까지만 하자..힘들디…