{"action":"closed","issue":{"url":"https://api.github.com/repos/alan-if/alan-docs/issues/14","repository_url":"https://api.github.com/repos/alan-if/alan-docs","labels_url":"https://api.github.com/repos/alan-if/alan-docs/issues/14/labels{/name}","comments_url":"https://api.github.com/repos/alan-if/alan-docs/issues/14/comments","events_url":"https://api.github.com/repos/alan-if/alan-docs/issues/14/events","html_url":"https://github.com/alan-if/alan-docs/issues/14","id":357426431,"node_id":"MDU6SXNzdWUzNTc0MjY0MzE=","number":14,"title":"Customization of PDF Template","user":{"login":"tajmone","id":11064292,"node_id":"MDQ6VXNlcjExMDY0Mjky","avatar_url":"https://avatars2.githubusercontent.com/u/11064292?v=4","gravatar_id":"","url":"https://api.github.com/users/tajmone","html_url":"https://github.com/tajmone","followers_url":"https://api.github.com/users/tajmone/followers","following_url":"https://api.github.com/users/tajmone/following{/other_user}","gists_url":"https://api.github.com/users/tajmone/gists{/gist_id}","starred_url":"https://api.github.com/users/tajmone/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/tajmone/subscriptions","organizations_url":"https://api.github.com/users/tajmone/orgs","repos_url":"https://api.github.com/users/tajmone/repos","events_url":"https://api.github.com/users/tajmone/events{/privacy}","received_events_url":"https://api.github.com/users/tajmone/received_events","type":"User","site_admin":false},"labels":[{"id":1035300766,"node_id":"MDU6TGFiZWwxMDM1MzAwNzY2","url":"https://api.github.com/repos/alan-if/alan-docs/labels/:book:%20Alan%20Manual","name":":book: Alan Manual","color":"bfdadc","default":false},{"id":1036635597,"node_id":"MDU6TGFiZWwxMDM2NjM1NTk3","url":"https://api.github.com/repos/alan-if/alan-docs/labels/:clock2:%20progress%20status","name":":clock2: progress status","color":"d0ffc9","default":false},{"id":1049326603,"node_id":"MDU6TGFiZWwxMDQ5MzI2NjAz","url":"https://api.github.com/repos/alan-if/alan-docs/labels/PDF%20Format","name":"PDF Format","color":"000000","default":false}],"state":"closed","locked":false,"assignee":{"login":"tajmone","id":11064292,"node_id":"MDQ6VXNlcjExMDY0Mjky","avatar_url":"https://avatars2.githubusercontent.com/u/11064292?v=4","gravatar_id":"","url":"https://api.github.com/users/tajmone","html_url":"https://github.com/tajmone","followers_url":"https://api.github.com/users/tajmone/followers","following_url":"https://api.github.com/users/tajmone/following{/other_user}","gists_url":"https://api.github.com/users/tajmone/gists{/gist_id}","starred_url":"https://api.github.com/users/tajmone/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/tajmone/subscriptions","organizations_url":"https://api.github.com/users/tajmone/orgs","repos_url":"https://api.github.com/users/tajmone/repos","events_url":"https://api.github.com/users/tajmone/events{/privacy}","received_events_url":"https://api.github.com/users/tajmone/received_events","type":"User","site_admin":false},"assignees":[{"login":"tajmone","id":11064292,"node_id":"MDQ6VXNlcjExMDY0Mjky","avatar_url":"https://avatars2.githubusercontent.com/u/11064292?v=4","gravatar_id":"","url":"https://api.github.com/users/tajmone","html_url":"https://github.com/tajmone","followers_url":"https://api.github.com/users/tajmone/followers","following_url":"https://api.github.com/users/tajmone/following{/other_user}","gists_url":"https://api.github.com/users/tajmone/gists{/gist_id}","starred_url":"https://api.github.com/users/tajmone/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/tajmone/subscriptions","organizations_url":"https://api.github.com/users/tajmone/orgs","repos_url":"https://api.github.com/users/tajmone/repos","events_url":"https://api.github.com/users/tajmone/events{/privacy}","received_events_url":"https://api.github.com/users/tajmone/received_events","type":"User","site_admin":false}],"milestone":{"url":"https://api.github.com/repos/alan-if/alan-docs/milestones/3","html_url":"https://github.com/alan-if/alan-docs/milestone/3","labels_url":"https://api.github.com/repos/alan-if/alan-docs/milestones/3/labels","id":3609895,"node_id":"MDk6TWlsZXN0b25lMzYwOTg5NQ==","number":3,"title":"PDF Conversion Toolchain","description":"Setup an automated toolchain to convert Alan documentation to PDF using shared assets and styling templates.\r\n","creator":{"login":"tajmone","id":11064292,"node_id":"MDQ6VXNlcjExMDY0Mjky","avatar_url":"https://avatars2.githubusercontent.com/u/11064292?v=4","gravatar_id":"","url":"https://api.github.com/users/tajmone","html_url":"https://github.com/tajmone","followers_url":"https://api.github.com/users/tajmone/followers","following_url":"https://api.github.com/users/tajmone/following{/other_user}","gists_url":"https://api.github.com/users/tajmone/gists{/gist_id}","starred_url":"https://api.github.com/users/tajmone/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/tajmone/subscriptions","organizations_url":"https://api.github.com/users/tajmone/orgs","repos_url":"https://api.github.com/users/tajmone/repos","events_url":"https://api.github.com/users/tajmone/events{/privacy}","received_events_url":"https://api.github.com/users/tajmone/received_events","type":"User","site_admin":false},"open_issues":0,"closed_issues":4,"state":"open","created_at":"2018-08-30T12:37:06Z","updated_at":"2018-12-19T21:11:10Z","due_on":null,"closed_at":null},"comments":1,"created_at":"2018-09-05T22:25:24Z","updated_at":"2018-12-19T21:11:09Z","closed_at":"2018-12-19T21:11:09Z","author_association":"COLLABORATOR","body":"The creation of custom DocBook XSL Stylesheets to provide the required/desired styling to the PDF _Alan Manual_ is a milestone for the public release of the new ADoc version of the manual.\r\n\r\nSample documents with extended features tests are available in the [`_dev/styles-tests/`][dev styles] folder:\r\n\r\n- [`styles-preview.pdf`][styles-preview.pdf]\r\n- [`tests-syntax-highlighting.pdf`][tests-syntax-highlighting.pdf]\r\n- [`tests-typography.pdf`][tests-typography.pdf]\r\n\r\nAlso, some PDF related issues have to be dealt with. Here is a task list of the WIP status:\r\n\r\n- [x] Customize XSL styles:\r\n    + [x] __LISTS__:\r\n        * [x] Ordered List Bullets:\r\n            - [x] Fix bullet types definition to use supported chars.\r\n            - [x] Use square bullet for all level (new font used).\r\n        * Q&A Lists: For some reason, items in this list inherit the full section numbering. (_**NOT IMPORTANT!**_)\r\n    + [x] __FOOTNOTES__:\r\n        * Footnotes in Tables: use numbers instead of letters (this seems to occur only inside tables, but in the Manual these are the only footnotes right now). (_**CAN'T FIX THIS!**_)\r\n        * [x] Smaller footnote marks, not bold.\r\n    + [x] __ADMONITIONS__:\r\n        * Nicer icons? (_**CAN'T FIX THIS!**_)\r\n        * ~~Icons colors according to type of admonition (red, yellow, green, blue, etc.)?~~ (moved to #39)\r\n        * ~~Add Light BG colors and borders? (could use different colors for each admonition type)~~ (moved to #39)\r\n    + [x] __CUSTOM BLOCKS__ (code, verbatim and examples):\r\n        * [x] Colors and styles):\r\n            - [x] Alan code examples\r\n            - [x] BNF rules (currently orange, like original).\r\n                + [x] Make it lighter, more pastel like.\r\n            - [x] Game transcripts\r\n                + [x] Bluish color scheme.\r\n            - [x] Shell output:\r\n                + [x] ~~Win 10 default CMD scheme (new version)~~.\r\n                + [x] Windows CMD legacy scheme (DARK_WHITE on DARK_BLUE).\r\n        * ~~Split Blocks: see if we can control orphan lines and/or prevent breaking up the block at page end.~~\r\n    + [x] Fix __MOCKUP SAMPLE BLOCKS__ in _[§ 2.4 Notation]_ via `role`s:\r\n        * [x] Alan code notation sample\r\n        * [x] BNF rules notation sample\r\n        * [x] Game transcripts notation sample\r\n    + [x] __EXAMPLE BLOCKS__:\r\n        * [x] Rounded corners.\r\n        *  ~~Very light BG color?~~\r\n    + [x] __COMMENTARY__ — Paragraphs with `\"commentary\"` role: add left margin.\r\n          (These appear below verbatim compiler output, as commentaries, eg in [_App C. Run-Time Messages_])\r\n    + [x] __FONT SIZES__:\r\n        * [x] Smaller Captions (Tables, Figures, etc.).\r\n        * [x] Smaller font in Example blocks Titles.\r\n        * [x] Inline Code: looks bigger than base font, should reduce size slightly.\r\n    + [x] __HEADER & FOOTER__:\r\n        * [x] Better alignment of page number and title.\r\n        * [x] No header on blank pages.\r\n        * [x] No header border on headerless pages.\r\n        * ~~Lighter colors? (grey)~~\r\n    + [x] __PREAMBLE__:\r\n        * [x] FIXED: removed bounding box.\r\n- [x] Fix problem with special Unicode chars not showing in PDF (eg, arrows symbols in Tables)\r\n- [x] __FONTS__:\r\n    + [x] Find appropriate fonts and include them in project\r\n        * [x] Main text: [Noto Sans] —  License: Apache 2.0.\r\n        * [x] Verbatim/Code: [Fira Sans Condensed] — License: SIL Open Font.\r\n        * [x] [Roboto Mono] — License:  Apache 2.0.\r\n    + [x] Set fonts in XSL stylesheets\r\n\r\nPlease, add any comments about missing styles that need to be handled, current styles that need fixing, and ideas to improve the Manual layout. They will be added to the tasks list.\r\n\r\n<!-----------------------------------------------------------------------------\r\n                               REFERENCE LINKS                                \r\n------------------------------------------------------------------------------>\r\n[PDF _Alan Manual_]: https://github.com/alan-if/alan-docs/blob/master/manual/manual.pdf\r\n[_App C. Run-Time Messages_]: https://htmlpreview.github.io/?https://github.com/alan-if/alan-docs/blob/master/manual/manual.html#_system_errors \"Live HTML previews of example of this styling\"\r\n\r\n[§ 2.4 Notation]: https://htmlpreview.github.io/?https://github.com/alan-if/alan-docs/blob/master/manual/manual.html#_notation\r\n\r\n[styles-preview.pdf]: https://github.com/alan-if/alan-docs/tree/master/_dev/styles-tests/styles-preview.pdf\r\n[tests-syntax-highlighting.pdf]: https://github.com/alan-if/alan-docs/tree/master/_dev/styles-tests/tests-syntax-highlighting.pdf\r\n[tests-typography.pdf]: https://github.com/alan-if/alan-docs/tree/master/_dev/styles-tests/tests-typography.pdf\r\n\r\n[dev styles]: https://github.com/alan-if/alan-docs/tree/master/_dev/styles-tests/\r\n\r\n<!-- fonts -->\r\n\r\n[Fira Sans Condensed]: https://fonts.google.com/specimen/Fira+Sans+Condensed \"View on Google Fonts\"\r\n[Noto Sans]: https://fonts.google.com/specimen/Noto+Sans \"View on Google Fonts\"\r\n[Roboto Mono]: https://fonts.google.com/specimen/Roboto+Mono \"View on Google Fonts\"\r\n<!-- EOF -->\r\n"}}
{"actor":{"display_login":"tajmone"}}