* Name the current generator in the hero paint-seam header The workspace generator moved from utils.hero.fit_paint_seams to utils.site.homepage.art.fit_paint_seams; the seam metadata is unchanged. Co-Authored-By: Claude Opus 5.5 <[email protected]> * Sync the homepages to the new installer version The workspace homepage installer now imports its roots from utils.core.paths; its own bytes feed the homepage version, so the six homepages point at assets/home/bf55006c61fda74c. Content is unchanged. Co-Authored-By: Claude Opus 5.5 <[email protected]> * Retire the Docker MkDocs preview and dead MkDocs-only config The site is built only with Zensical. The root Dockerfile and compose file built a MkDocs Material + glightbox preview that nothing else used, so remove them and the "Docker deployment" section of the contribution guide in all six languages. In mkdocs.yml, drop the keys the Zensical build never reads: glightbox (filtered out by the builder), theme.features, extra_css and extra_javascript (replaced by overrides/zensical/zensical.toml), and docs_dir, site_dir and theme.custom_dir (set by the builder). The effective Zensical config is byte-identical for every language. codes/Dockerfile (the code runtime environment) is unrelated and kept. Co-Authored-By: Claude Opus 5.5 <[email protected]> * Remove the unused KaTeX script and the shadowed extra.css overrides/javascripts/katex.js is referenced by no page or config (MathJax renders formulas) and was only published as a dead file. overrides/stylesheets/extra.css is always replaced by overrides/zensical/stylesheets/extra.css during the build. Co-Authored-By: Claude Opus 5.5 <[email protected]> --------- Co-authored-by: Claude Opus 5.5 <[email protected]>
4.5 KiB
Присоединяйтесь к созданию книги
Возможности автора ограничены, поэтому в книге неизбежно могут встречаться упущения и ошибки. Просим отнестись к этому с пониманием. Если вы заметите опечатки, неработающие ссылки, пропуски в содержании, двусмысленные формулировки, неясные объяснения или неудачную структуру изложения, пожалуйста, помогите нам это исправить, чтобы читатели получили более качественный учебный ресурс.
Все GitHub ID авторов будут указаны на главных страницах репозитория книги, веб-версии и PDF-версии в знак благодарности за их бескорыстный вклад в сообщество открытого исходного кода.
!!! success "Сила открытого исходного кода"
Интервал между двумя тиражами бумажной книги обычно довольно велик, поэтому обновлять содержание очень неудобно.
В этой же открытой книге цикл обновления содержания сокращается до нескольких дней, а иногда даже до нескольких часов.
Небольшие правки содержания
Как показано на рисунке ниже, в правом верхнем углу каждой страницы есть «значок редактирования». Текст или код можно изменить следующим образом.
- Нажмите на «значок редактирования». Если появится сообщение «You need to fork this repository», согласитесь с этим действием.
- Измените содержимое исходного Markdown-файла, проверьте корректность правок и постарайтесь сохранить единый стиль оформления.
- Внизу страницы заполните описание изменений, затем нажмите кнопку «Propose file change». После перехода на следующую страницу нажмите кнопку «Create pull request», чтобы отправить pull request.
Изображения нельзя изменить напрямую, поэтому проблему с ними нужно описывать через новый Issue или комментарий. Мы постараемся как можно быстрее исправить и обновить изображение.
Создание содержания
Если вам интересно участвовать в этом проекте с открытым исходным кодом, например переводить код на другие языки программирования или расширять содержание статей, то следует придерживаться следующего процесса Pull Request.
- Войдите в GitHub и сделайте Fork репозитория книги в свой личный аккаунт.
- Перейдите на страницу своего Fork-репозитория и с помощью команды
git cloneклонируйте репозиторий локально. - Создавайте и редактируйте содержание локально, затем проведите полное тестирование и проверьте корректность кода.
- Зафиксируйте локальные изменения, после чего выполните Push в удаленный репозиторий.
- Обновите страницу репозитория и нажмите кнопку «Create pull request», чтобы инициировать pull request.
