{"id":21253934,"url":"https://github.com/courseorchestra/course-doc","last_synced_at":"2025-03-15T05:43:49.530Z","repository":{"id":90896536,"uuid":"143001670","full_name":"CourseOrchestra/course-doc","owner":"CourseOrchestra","description":"Templates for creating asciidoctor documentation","archived":false,"fork":false,"pushed_at":"2023-03-24T19:22:35.000Z","size":2869,"stargazers_count":14,"open_issues_count":0,"forks_count":3,"subscribers_count":3,"default_branch":"master","last_synced_at":"2025-01-21T21:15:37.113Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"XSLT","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/CourseOrchestra.png","metadata":{"files":{"readme":"README.adoc","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2018-07-31T10:51:59.000Z","updated_at":"2023-10-25T12:05:05.000Z","dependencies_parsed_at":null,"dependency_job_id":"45ec2619-f27e-4a89-86dd-c8968788dd44","html_url":"https://github.com/CourseOrchestra/course-doc","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/CourseOrchestra%2Fcourse-doc","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/CourseOrchestra%2Fcourse-doc/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/CourseOrchestra%2Fcourse-doc/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/CourseOrchestra%2Fcourse-doc/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/CourseOrchestra","download_url":"https://codeload.github.com/CourseOrchestra/course-doc/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":243690149,"owners_count":20331729,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2024-11-21T03:53:31.366Z","updated_at":"2025-03-15T05:43:49.507Z","avatar_url":"https://github.com/CourseOrchestra.png","language":"XSLT","readme":"= Шаблоны документации КУРС\r\n\r\n[WARNING]\r\nСведения в документе устарели. Для получения pdf-файла мы разработали проект https://github.com/CourseOrchestra/asciidoctor-open-document .\r\n\r\n== Краткое описание\r\n\r\nВ папке _doc_ приведен шаблон -- расширение для DocBook XSL, -- обеспечивающий конвертацию docbook-файла в _pdf_ через _xsl-fo_. Основан на шаблоне, который поставляется вместе с _AsciidocFX_.\r\n\r\nВариант в меру громоздкий и не очень удобен для кастомизации, но  \u003c\u003calternatives, альтернативы\u003e\u003e  пока не понятны.\r\n\r\n== Использование совместно с AsciidocFX\r\n\r\nДля использования функции экспорта в pdf при помощи редактора https://asciidocfx.com/[AsciidocFX] скачайте это приложение и установите его. Далее в папке установки перейдите в _conf\\docbook-config_ и замените файлы _fo-pdf.xsl_ и _common.xsl_ на соответствующие файлы, содержащиеся в папке _template/docbook-xsl_ репозитория.\r\n\r\nВ папке _doc_ репозитория находится файл _db_template_examples.adoc_, содержащий описание всех возможных вариантов использования шаблона c примерами. Сохраните папку _doc_ на диске и экспортируйте его в pdf при помощи _AsciidocFX_.\r\n\r\n== Использование для автоматической сборки\r\n\r\nДля автоматической сборки используйте проект https://github.com/asciidoctor/asciidoctor-fopub[asciicotor-fopub].\r\n\r\nЕсли нужны скрипты, которые мы используем для сборки документации, поднимите _Issue_, выложим их в отдельную папку.\r\n\r\n\r\n[[alternatives]]\r\n== Альтернативные варианты\r\n\r\n. https://github.com/Mogztter/asciidoctor-web-pdf [Asciidoctor Web PDF]. Лучшая альтернатива, если достаточно фич. Позволяет генерировать pdf через html с использованием спецификаций W3C https://www.w3.org/TR/css-page-3/[Paged Media] и https://www.w3.org/TR/css-gcpm-3/[Generated Content for Paged Media].\r\n. https://github.com/asciidoctor/asciidoctor-pdf[Asciidoctor PDF]. Самый простой вариант, т.к. позволяет осуществлять конвертацию напрямую из asciidoc-формата. Однако на текущий момент обладает рядом ограничений, которые не позволяют пока его использовать для нашей отчетной документации. Эти ограничения потихоньку снимаются и есть надежда, что все-таки это проект будет доведен до требуемого состояния.\r\n. http://dblatex.sourceforge.net/[Dblatex]. Это довольно старый и отработанный проект. Однако он работает на второй версии питона и требует довольно больших усилий для запуска и настройки. \r\n. https://github.com/asciidoctor/asciidoctor-latex[Asciidoctor LaTeX]. Проект, который не развивается. Не понятно что делает, то ли _TeX_ интегрирует в _Asciidoctor_, то ли _Asciidoctor_ конвертирует в _TeX_. Были какие-то разговоры, что будет отдельный проект по конвертации в _TeX_, но ничего не видно.\r\n","funding_links":[],"categories":[],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcourseorchestra%2Fcourse-doc","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fcourseorchestra%2Fcourse-doc","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcourseorchestra%2Fcourse-doc/lists"}