Build HTML docs: manpage readers are very uncommon on Windows

This commit is contained in:
Martijn van Beurden 2024-06-26 15:33:54 +02:00
parent 9dd697bb8d
commit 9b945dcb90
5 changed files with 294 additions and 1 deletions

2
.gitignore vendored
View File

@ -38,7 +38,9 @@ m4/ltsugar.m4
m4/ltversion.m4
m4/lt~obsolete.m4
man/flac.1
man/flac.html
man/metaflac.1
man/metaflac.html
missing
objs/debug
objs/release

View File

@ -22,8 +22,15 @@ flac.1: flac.md
metaflac.1: metaflac.md
pandoc --standalone --to man $? > $@
flac.html: flac.md
pandoc --standalone --to html --css style.css -B header.inc -A footer.inc --embed-resources $? > $@
metaflac.html: metaflac.md
pandoc --standalone --to html --css style.css -B header.inc -A footer.inc --embed-resources $? > $@
man_MANS = flac.1 metaflac.1
doc_DATA = flac.html metaflac.html
else
if FLaC__HAS_PREBUILT_MANPAGES
@ -31,4 +38,4 @@ man_MANS = flac.1 metaflac.1
endif
endif
EXTRA_DIST = flac.1 metaflac.1 flac.md metaflac.md
EXTRA_DIST = flac.1 metaflac.1 flac.md metaflac.md flac.html metaflac.html

5
man/footer.inc Normal file
View File

@ -0,0 +1,5 @@
<div class="copyright">
<hr />
Copyright (c) 2000-2009 Josh Coalson, 2011-2024 Xiph.Org Foundation
</div>
</div>

31
man/header.inc Normal file
View File

@ -0,0 +1,31 @@
<div class="logo">
<img src="data:image/png;base64,
iVBORw0KGgoAAAANSUhEUgAAAKEAAABQBAMAAACDsQg5AAAAMFBMVEUAAABTAgC1AAMkMh/7AABQ
UQBbYFklgx8nnieiogCZm5i9wLzIysfY29f5+gD7/vuN5xJAAAAEtklEQVRYw92YP4vbPBjA9SKq
wU5I+xX6CQyBDHcX0qEf4F26CwwenJjc1vWFd+n4rt0MhQzOhQsUPLgXEihkSHNcIJAhdyGF7qVQ
uOGS4Nd/ZFmyZV+Sc4dWoER6LP2sP8/z6JEBKD69ePG8WOBfr1+/ynoGNVwkEVlr150VSEQez3V/
BuWaPlg8mYhufKD7AIB85bPvn0y8DIDuBoBKUHgyUQ6B7q4wIhmi6yqHE4X6KEVAFx9BFKUGJY6O
IL58+Zz799OQEmfHryO7nnBNiffFEBEFegpZCDHSHdeyOsUQQ4i7YCrFEJXiiI3IAgsjtiMvISLW
tI6aouj+imcmWG2zEI6od8mWsa4YNkOho2QQeyviJVarO4Unxmq1jXtDag+bQPjs/fv/ohy2iNXb
3SWIsb2T3pxXIUv/7Pv3r17+5uewhZtNlJlnkVc33IQwRUQ5xBLbG6eae8kUEKUcYoXtPE/Ombzm
IGKD7bwRDPFBNOtSDrHNdVdSEs+dCoiVHCI/xb4nueEkfvu09rRziGuu/4zf/NjMsg4tIXHqaPqU
euPkpPtC4k02Ed6GFn1CibSxpfXIpKN19HM462pVI55C09SEXSucK7mnO73xdfNkHTZK20zcIdOb
SUQmc8peNo8nIiJr8AYJjiE2p1M7JrbZIR5FRJfhqkXEoUhnDiISzdqpRLZmDDxJ/LoPkerzJpQh
oRZCz1ai/BiRNzlK3CNYzyAmTI4SwdHEdpIoCYnMOgY5h5gAuvNc4jd2v8VE0n/3ZVAUsUxPEqJE
c/HO7E+MpYgn9o8lXkZDjIpz6OZo+B7EYbxoZUJaP2aF+cSg+5aJBOZRvI4zbSayGzGRCQFlcs7w
3gwqh2k4ZFSlRIjkJN6Fg2yEHtc7BRQuP0LEcYMZjRaCsEoipwJ89+4fNj8y6+DGTW4ns+gt/plU
1ddkrPsT1/R4PKPwy3RIcQAxuiB3unEEUBdEAPsTk67HJyYCqSAU2p9YFhBF096fKImIgsAnQTzP
8Y9DATEpxAfoI91iniinouYDToX4kryLifyGBc3evPnbzyDKOWdhK+rYYYiImfcW5+zM7m4cE6NK
L+y4RKynRTccUEzcdrQqvchuLVqBgbI8KMi9tTRV4aTei3CmXeckvet0RN/YvBTdPw8k7pF+E+I5
m8GvSRotqalC/DEAcbVcIBrTop0q0NSU2ZoRz/rt23M2B1cBW8U1FfhfcW2kAb+o2FBTUCirqUhB
QGuioBYKNcN/rpF1/De5M9L46sOnq9pk4hFbXdO5kK25Xe6OnO6p8xmAZU/GDcn5UkF+i089r6Hs
rGTns3FhZhBR30EjuYUbHtGGPxZINhW7CxZjWDJVAHH9FDcquFkp4xaAPyTDrBtg0AL2AmUTbWl7
bdxdK8Aeg/vWEg1N+3q6aD7AnmfMg4FHrAOPqNQBGoEKLjWBYUyXcwCyiWiEzrAUjPGneaZ7/12g
4pIOHCD1y6e4XVHCMaJ4jOoC9bOIpg0mF7WJE67jste0xnbdGjkXTWcM0LKnT4aSdVuWHMdfR23i
lJxVyfpodLNmDbEKTlSgezuJUQfUOlDHYSGQ6RrWNe8XBTUUCK0atBTUydKePz79Dy84W9TLWTUv
AAAAAElFTkSuQmCC" alt="FLAC Logo" id="logo" />
</div>
<div class="content">

248
man/style.css Normal file
View File

@ -0,0 +1,248 @@
/*
* Copyright (c) 2000-2009 Josh Coalson, 2011-2024 Xiph.Org Foundation
* Permission is granted to copy, distribute and/or modify this document
* under the terms of the GNU Free Documentation License, Version 1.1
* or any later version published by the Free Software Foundation;
* with no invariant sections.
* A copy of the license can be found at http://www.gnu.org/copyleft/fdl.html
*/
html
{
background-color: #B3D9B3;
}
body
{
position: relative;
display: block;
background-color: #F2F2DE;
color: black;
margin: 0 auto;
padding: 0 0 10px 0;
max-width: 1200px;
font-family: lucida, verdana, helvetica, arial, sans-serif;
font-weight: normal;
font-size: 100%;
}
div.logo
{
position: relative;
background-color: black;
padding: 1px;
text-align: center;
}
div.navbar {
font-weight: bold;
}
@media (min-width: 800px)
{
div.navbar
{
display: flex;
gap: 5px;
flex-direction: row;
padding: 8px;
text-align: center;
}
div.navbar:before, div.navbar:after
{
content: "";
flex: 1 1;
border-bottom: 2px solid;
margin: 10px;
}
div.navbar div:first-child a::after, div.navbar div:last-child a:not(:last-child)::after {
content: " - ";
}
#navbarshow
{
display: none;
}
}
@media (max-width: 799px)
{
div.navbar div
{
display: flex;
gap: 5px;
flex-direction: row;
padding: 8px;
text-align: center;
}
div.navbar div:before, div.navbar div:after
{
content: "";
flex: 1 1;
flex-grow: 3;
border-bottom: 2px solid;
margin: 10px;
}
div.navbar div a:not(:last-child)::after {
content: " - ";
}
#navbarshow
{
display: none;
}
}
div.navbar a
{
color: #000;
text-decoration: none;
}
div.content
{
padding: 0 25px;
}
div.box_footer
{
border-width: 0px 0px 1px 0px;
border-style: solid;
border-color: black;
background-color: #EEEED4;
padding: 3px;
}
div.box_body
{
background-color: #EEEED4;
padding: 0px 3px 0px 3px;
font-family: lucida, verdana, helvetica, arial, sans-serif;
font-weight: normal;
font-size: 100%;
}
#newsbox h3
{
margin: 5px 0 0 0;
font-size: 0.9em;
}
#newsbox p
{
margin: 0;
}
div.smallbox
{
text-align: left;
margin: 0 0 0 8px;
background-color: #EEEED4;
}
div.smallbox_title
{
text-align: center;
border-width: 1px 0px 0px 0px;
border-style: solid;
border-color: black;
background-color: #D3D4C5;
padding: 3px;
font-family: lucida, verdana, helvetica, arial, sans-serif;
font-weight: bold;
font-size: 100%;
}
div.smallbox_header
{
border-width: 1px 0px 0px 0px;
border-style: solid;
border-color: black;
background-color: #EEEED4;
padding: 3px;
}
div.smallbox_footer
{
border-width: 0px 0px 1px 0px;
border-style: solid;
border-color: black;
background-color: #EEEED4;
padding: 3px;
}
div.smallbox_body
{
background-color: #EEEED4;
padding: 0px 3px 0px 3px;
font-family: lucida, verdana, helvetica, arial, sans-serif;
font-weight: normal;
font-size: 80%;
}
div.copyright
{
text-align: left;
padding-bottom: 10px;
}
div.copyright hr {
margin: 20px 0;
}
span.commandname
{
font-family: monospace;
font-weight: bold;
}
span.command
{
font-family: monospace;
font-weight: bold;
}
span.argument
{
font-family: monospace;
}
span.code
{
font-family: monospace;
}
a:link, a:visited, a:active, a:hover
{
color:#336699;
background-color:transparent;
}
div.imageflex
{
display: flex;
flex-wrap: wrap;
justify-content: center;
padding: 0 20px
}
div.imageflex div
{
width: 200px;
height: 125px;
padding: 10px;
text-align: center;
}
div.imageflex div span {
display: block;
text-align: center;
}