aimclub / open-source-ops

Полезные советы для open-source разработок (в том числе в области AI/ML)
https://t.me/itmo_opensource
BSD 3-Clause "New" or "Revised" License
88 stars 7 forks source link

Create beatuful auto-generated webpage with all materials #40

Closed nicl-nno closed 1 year ago

nicl-nno commented 1 year ago

Не уверен насчет read-the-docs, возможно тут лучше githubio подойдет.

nicl-nno commented 1 year ago

@DenisSidoren не знаешь, как это проще всего сделать?

DenisSidoren commented 1 year ago

Со сборкой веб-страниц не сталкивался. Но я думаю, что ртд подойдет отлично. Просто придется структуру репозитория подогнать полностью под нужды сфинкса. В таком случае основной страницей уже будет сайт с "докой", а не репозиторий. Однако, мне кажется более удобным чтение контента через формат документации, чем заход-выход в директории и файлы в репо

nicl-nno commented 1 year ago

Не будет проще через github pages? Тогда вообще ничего не нужно будет менять по структуре.

DenisSidoren commented 1 year ago

@nicl-nno я с их генерацией не сталкивался пока, поэтому не могу сказать, будет ли это проще и удобнее