github-mirror/lkmpg
2
0
Fork 0
mirror of https://github.com/sysprog21/lkmpg.git synced 2024-11-22 13:58:19 +08:00
Code Issues Actions Packages Projects Releases Wiki Activity
b9b37fc39f
lkmpg/html.cfg

92 lines
1.7 KiB
INI
Raw Normal View History

Generate HTML via make4ht (#20) This patch generates HTML files with "make4ht" in the "html" directory. Known issues with "make4ht": Running "make4ht -suf html5 -d html lkmpg.tex" will cause the following flaws: 1. The layout was unsatisfying. 2. After parsing TeX, it stoped at "\tableofcontents" with errors. 3. Several unneeded files were generated. 4. No way to specify the destination filename for HTML generation. Solutions/workaround: 1. Use customized configuration file "html.cfg" to specify the layout style. 2. Turn off the \tableofcontents section when using make4ht. However, this results in the lack of table of contents in HTML. It can be fixed by appending "\Configure{tableofcontents*}{chapter,section,subsection}" to configuration file. 3. The build system removes the temporary files. 4. Use a symbolic link "index.html" to "lkmpg.html".
2021-08-02 02:42:39 +08:00
\Preamble{xhtml}
\Configure{tableofcontents*}{chapter,section,subsection}
Rewrite CSS to support scaling This changes the layout to use the default font size with a reasonable max width and margins around the body. Elements that would overflow on narrow displays are changed to wrap (.author) or present a scroll bar as necessary (figure, .verbatim, .fancyvrb). The properties on html and body are set such that there is no full-document vertical scrolling. Inline math is displayed in the same size as the surrounding text.
2021-08-05 18:37:55 +08:00
\Css{html {
width: 100vw;
overflow-x: hidden;
}}
Add Manrope variable font (#118) Manrope is an open-source modern sans-serif font family.
2021-10-10 21:34:25 +08:00
\Css{@font-face {
font-family: Manrope;
src: url(Manrope_variable.ttf);
}}
Rewrite CSS to support scaling This changes the layout to use the default font size with a reasonable max width and margins around the body. Elements that would overflow on narrow displays are changed to wrap (.author) or present a scroll bar as necessary (figure, .verbatim, .fancyvrb). The properties on html and body are set such that there is no full-document vertical scrolling. Inline math is displayed in the same size as the surrounding text.
2021-08-05 18:37:55 +08:00
\Css{body {
Improve readability (#96) This new foreground + background color maintains the minimum of 7:1 contrast ratio as specified by WCAG (this has 7.36:1) and is the same colors Firefox reading mode uses when choosing the sepia theme. Fonts are too small by default, using responsive units (em) let's me increase them, I am unsure where or if there is font-size specified for parent anywhere but it seems to have been manually decreased. Increased max-width slightly to adjust for new size and more standard line-height, so the doc doesn't feel significantly longer, still maintains good eye travel.
2021-09-09 11:20:41 +08:00
max-width: 55rem;
Rewrite CSS to support scaling This changes the layout to use the default font size with a reasonable max width and margins around the body. Elements that would overflow on narrow displays are changed to wrap (.author) or present a scroll bar as necessary (figure, .verbatim, .fancyvrb). The properties on html and body are set such that there is no full-document vertical scrolling. Inline math is displayed in the same size as the surrounding text.
2021-08-05 18:37:55 +08:00
box-sizing: border-box;
padding: 1rem;
Generate HTML via make4ht (#20) This patch generates HTML files with "make4ht" in the "html" directory. Known issues with "make4ht": Running "make4ht -suf html5 -d html lkmpg.tex" will cause the following flaws: 1. The layout was unsatisfying. 2. After parsing TeX, it stoped at "\tableofcontents" with errors. 3. Several unneeded files were generated. 4. No way to specify the destination filename for HTML generation. Solutions/workaround: 1. Use customized configuration file "html.cfg" to specify the layout style. 2. Turn off the \tableofcontents section when using make4ht. However, this results in the lack of table of contents in HTML. It can be fixed by appending "\Configure{tableofcontents*}{chapter,section,subsection}" to configuration file. 3. The build system removes the temporary files. 4. Use a symbolic link "index.html" to "lkmpg.html".
2021-08-02 02:42:39 +08:00
margin: 0 auto;
Rewrite CSS to support scaling This changes the layout to use the default font size with a reasonable max width and margins around the body. Elements that would overflow on narrow displays are changed to wrap (.author) or present a scroll bar as necessary (figure, .verbatim, .fancyvrb). The properties on html and body are set such that there is no full-document vertical scrolling. Inline math is displayed in the same size as the surrounding text.
2021-08-05 18:37:55 +08:00
overflow-x: hidden;
Improve readability (#96) This new foreground + background color maintains the minimum of 7:1 contrast ratio as specified by WCAG (this has 7.36:1) and is the same colors Firefox reading mode uses when choosing the sepia theme. Fonts are too small by default, using responsive units (em) let's me increase them, I am unsure where or if there is font-size specified for parent anywhere but it seems to have been manually decreased. Increased max-width slightly to adjust for new size and more standard line-height, so the doc doesn't feel significantly longer, still maintains good eye travel.
2021-09-09 11:20:41 +08:00
background-color: \#F4ECD8;
color: \#5B464B;
line-height: 1.5;
}}
\Css{a {
color: \#0060DF;
}}
\Css{p, a {
Workaround inconsistent text scaling (#100) p + pre remains at em as we want to use the parent element here (however rem could be used too, just requires a bigger value). I am setting it to 110% size, otherwise some code blocks have relatively small text. The smaller code blocks do appear bigger.
2021-09-10 12:08:57 +08:00
font-size: 1.2rem;
Add Manrope variable font (#118) Manrope is an open-source modern sans-serif font family.
2021-10-10 21:34:25 +08:00
font-family: Manrope;
Improve readability (#96) This new foreground + background color maintains the minimum of 7:1 contrast ratio as specified by WCAG (this has 7.36:1) and is the same colors Firefox reading mode uses when choosing the sepia theme. Fonts are too small by default, using responsive units (em) let's me increase them, I am unsure where or if there is font-size specified for parent anywhere but it seems to have been manually decreased. Increased max-width slightly to adjust for new size and more standard line-height, so the doc doesn't feel significantly longer, still maintains good eye travel.
2021-09-09 11:20:41 +08:00
}}
\Css{p + pre {
font-size: 1.1em;
Rewrite CSS to support scaling This changes the layout to use the default font size with a reasonable max width and margins around the body. Elements that would overflow on narrow displays are changed to wrap (.author) or present a scroll bar as necessary (figure, .verbatim, .fancyvrb). The properties on html and body are set such that there is no full-document vertical scrolling. Inline math is displayed in the same size as the surrounding text.
2021-08-05 18:37:55 +08:00
}}
\Css{div.author {
white-space: normal;
}}
\Css{img.math {
height: 1rem;
vertical-align: top;
Generate HTML via make4ht (#20) This patch generates HTML files with "make4ht" in the "html" directory. Known issues with "make4ht": Running "make4ht -suf html5 -d html lkmpg.tex" will cause the following flaws: 1. The layout was unsatisfying. 2. After parsing TeX, it stoped at "\tableofcontents" with errors. 3. Several unneeded files were generated. 4. No way to specify the destination filename for HTML generation. Solutions/workaround: 1. Use customized configuration file "html.cfg" to specify the layout style. 2. Turn off the \tableofcontents section when using make4ht. However, this results in the lack of table of contents in HTML. It can be fixed by appending "\Configure{tableofcontents*}{chapter,section,subsection}" to configuration file. 3. The build system removes the temporary files. 4. Use a symbolic link "index.html" to "lkmpg.html".
2021-08-02 02:42:39 +08:00
}}
Fix alignment problem in code block (#45) In rendered HTML, the line number should be right aligned, and code should be left aligned accordingly. In addition, this patch added the basic build instructions, so that someone can generated the PDF and HTML files. Close #44
2021-08-08 01:29:50 +08:00
\Css{pre.fancyvrb, {
white-space: pre;
}}
Rewrite CSS to support scaling This changes the layout to use the default font size with a reasonable max width and margins around the body. Elements that would overflow on narrow displays are changed to wrap (.author) or present a scroll bar as necessary (figure, .verbatim, .fancyvrb). The properties on html and body are set such that there is no full-document vertical scrolling. Inline math is displayed in the same size as the surrounding text.
2021-08-05 18:37:55 +08:00
\Css{figure, .fancyvrb, .verbatim {
margin-inline: 0;
overflow-x: auto;
Generate HTML via make4ht (#20) This patch generates HTML files with "make4ht" in the "html" directory. Known issues with "make4ht": Running "make4ht -suf html5 -d html lkmpg.tex" will cause the following flaws: 1. The layout was unsatisfying. 2. After parsing TeX, it stoped at "\tableofcontents" with errors. 3. Several unneeded files were generated. 4. No way to specify the destination filename for HTML generation. Solutions/workaround: 1. Use customized configuration file "html.cfg" to specify the layout style. 2. Turn off the \tableofcontents section when using make4ht. However, this results in the lack of table of contents in HTML. It can be fixed by appending "\Configure{tableofcontents*}{chapter,section,subsection}" to configuration file. 3. The build system removes the temporary files. 4. Use a symbolic link "index.html" to "lkmpg.html".
2021-08-02 02:42:39 +08:00
}}
Fix alignment problem in code block (#45) In rendered HTML, the line number should be right aligned, and code should be left aligned accordingly. In addition, this patch added the basic build instructions, so that someone can generated the PDF and HTML files. Close #44
2021-08-08 01:29:50 +08:00
\Css{.ecrm-0500 {
Generate HTML via make4ht (#20) This patch generates HTML files with "make4ht" in the "html" directory. Known issues with "make4ht": Running "make4ht -suf html5 -d html lkmpg.tex" will cause the following flaws: 1. The layout was unsatisfying. 2. After parsing TeX, it stoped at "\tableofcontents" with errors. 3. Several unneeded files were generated. 4. No way to specify the destination filename for HTML generation. Solutions/workaround: 1. Use customized configuration file "html.cfg" to specify the layout style. 2. Turn off the \tableofcontents section when using make4ht. However, this results in the lack of table of contents in HTML. It can be fixed by appending "\Configure{tableofcontents*}{chapter,section,subsection}" to configuration file. 3. The build system removes the temporary files. 4. Use a symbolic link "index.html" to "lkmpg.html".
2021-08-02 02:42:39 +08:00
font-size: 70\%;
Fix alignment problem in code block (#45) In rendered HTML, the line number should be right aligned, and code should be left aligned accordingly. In addition, this patch added the basic build instructions, so that someone can generated the PDF and HTML files. Close #44
2021-08-08 01:29:50 +08:00
font-style: italic;
Generate HTML via make4ht (#20) This patch generates HTML files with "make4ht" in the "html" directory. Known issues with "make4ht": Running "make4ht -suf html5 -d html lkmpg.tex" will cause the following flaws: 1. The layout was unsatisfying. 2. After parsing TeX, it stoped at "\tableofcontents" with errors. 3. Several unneeded files were generated. 4. No way to specify the destination filename for HTML generation. Solutions/workaround: 1. Use customized configuration file "html.cfg" to specify the layout style. 2. Turn off the \tableofcontents section when using make4ht. However, this results in the lack of table of contents in HTML. It can be fixed by appending "\Configure{tableofcontents*}{chapter,section,subsection}" to configuration file. 3. The build system removes the temporary files. 4. Use a symbolic link "index.html" to "lkmpg.html".
2021-08-02 02:42:39 +08:00
color: gray;
Fix alignment problem in code block (#45) In rendered HTML, the line number should be right aligned, and code should be left aligned accordingly. In addition, this patch added the basic build instructions, so that someone can generated the PDF and HTML files. Close #44
2021-08-08 01:29:50 +08:00
width: 1.5rem;
display: inline-block;
Generate HTML via make4ht (#20) This patch generates HTML files with "make4ht" in the "html" directory. Known issues with "make4ht": Running "make4ht -suf html5 -d html lkmpg.tex" will cause the following flaws: 1. The layout was unsatisfying. 2. After parsing TeX, it stoped at "\tableofcontents" with errors. 3. Several unneeded files were generated. 4. No way to specify the destination filename for HTML generation. Solutions/workaround: 1. Use customized configuration file "html.cfg" to specify the layout style. 2. Turn off the \tableofcontents section when using make4ht. However, this results in the lack of table of contents in HTML. It can be fixed by appending "\Configure{tableofcontents*}{chapter,section,subsection}" to configuration file. 3. The build system removes the temporary files. 4. Use a symbolic link "index.html" to "lkmpg.html".
2021-08-02 02:42:39 +08:00
-webkit-user-select: none;
-moz-user-select: none;
-o-user-select: none;
user-select: none;
}}
Add PDF download link in html only Close #64
2021-08-17 17:35:36 +08:00
\Css{.flushright:first-child {
position:absolute;
top: 10px;
right: 50px;
}}
Add GitHub buttons in rendered HTML (#85) GitHub buttons are rendered in the generated HTML: one is GitHub project page; another is PDF download. Close #84
2021-08-31 23:49:18 +08:00
\Css{.right {
text-align: right;
}}
Add PDF download link in html only Close #64
2021-08-17 17:35:36 +08:00
Add GitHub buttons in rendered HTML (#85) GitHub buttons are rendered in the generated HTML: one is GitHub project page; another is PDF download. Close #84
2021-08-31 23:49:18 +08:00
\AtBeginDocument{%
\Configure{@HEAD}{\HCode{
<script async defer src="https://buttons.github.io/buttons.js"></script>
<div class="right">
<a class="github-button" href="https://github.com/sysprog21/lkmpg" data-size="large" aria-label="View on GitHub">View on GitHub</a>
<a class="github-button" href="https://github.com/sysprog21/lkmpg/releases/download/latest/lkmpg.pdf" data-icon="octicon-download" data-size="large" aria-label="Download PDF document">Download PDF document</a>
<br><br>
</div>
\Hnewline}}
}
\begin{document}
Improve readability (#96) This new foreground + background color maintains the minimum of 7:1 contrast ratio as specified by WCAG (this has 7.36:1) and is the same colors Firefox reading mode uses when choosing the sepia theme. Fonts are too small by default, using responsive units (em) let's me increase them, I am unsure where or if there is font-size specified for parent anywhere but it seems to have been manually decreased. Increased max-width slightly to adjust for new size and more standard line-height, so the doc doesn't feel significantly longer, still maintains good eye travel.
2021-09-09 11:20:41 +08:00
\EndPreamble
Reference in New Issue Copy Permalink