Смотрю видео (2:21:04) "Documenting Your Project in Sphinx" с архивом на GitHub ... и нахожу два отличных справочника

Понравились два приема (после просмотра первого часа видео). Пробую здесь не конспектировать, а отмечать интересные идеи (вопросы, приемы, идеи...). Буlу дополнять пост в процессе просмотра оставшихся 80 минут.
После следующих 10 минут просмотра пришла в голову мысль - на бесплатный хостинг залить примеры из видео. Посмотрел на Гугл-сайтах. Там нельзя использовать свои страницы... И вот именно тут "осенило" и тут же нашел два готовых отличных чужих справочника... продвинутый Sampledoc и (азы) Documenting Your Project Using Sphinx

Устанавливаем в Kali "sphinx-bootstrap-theme"

Меня заинтересовала тема "sphinx-bootstrap-theme" ... я нашел несколько дистрибутивов на GitHub, но понравившийся мне предлагал установку только под Linux. Я не уверен в себе, потому хочу учится на "правильных примерах". Потому здесь установил Sphinx и тему ... и распечатал структуру папок и conf.py для Spinx "/usr/local/lib/python2.7/dist-packages/sphinx/config.py"... а потом записал весь процесс успешной установки в Debian

При попытке запустить "sphinx python quickstart.py" выскочила ошибка AttributeError: 'module' object has no attribute 'getlocale'

Здесь я решил опубликовать назидательный пример моей глупости. В процессе установки темы для движка "Сфинкс" я тупо перепутал запускаемый файл и "вляпался" в "неразрешимую" ошибу. В подобные ситуации попадал и раньше, но в последнее время стал про них забывать... А надо помнить!

Распечатка Sphinx quickstart.py оказалась достаточно длинной

Оказалось, что здесь содержится почти вся информация (словно коды парсятся отсюда ?) обо всех файлах проекта, включая конфигурационный. Есть еще разделы файла с комментариями: General configuration, Options for HTML output, Options for LaTex output...

Начинаем изучать Sphinx HTML theming support

Этот пост - классический конспект. Я читал страницу документации "HTML theming support" и разбирался с тем, где находятся "встроенные темы", каковы структура папок для тем... Потом я решил поискать варианты готовых тем, сначла, просто примеры, а потом и пакеты, нашел sphinx-bootstrap theme...

Первый сайт на Sphinx (sphinx-quickstart, make html, make clear)

Возвращение к изучению Sphinx потребовало повторного чтения тех же самых страниц документации. Потом я попрактиковался и создал сайт "aksiomatic" (file:///C:/Users/kiss/Documents/sphinx/aksiomatic/build/html/genindex.html). Здесь я записал основные команды и шаги... и распечатал основные файлы Make.bat, index.rst, conf.py .

Sphinx - три отличные ссылки и два посредственных видео

Sphinx - это фреймворк для создания статичных сайтов. Его используют не только для создания мануалов с фрагментами кода, но и для написания книг. Я давно ищу варианты не только для книг, но и для совместных исследований... Здесь можно использовать простые текстовые шаблоны страниц... и много чего еще...