c1bde05495
- extras/hbdoc/_tmplate.prg
- extras/hbdoc/hbdoc.ch
* extras/hbdoc/_genbase.prg
* extras/hbdoc/_genhtml.prg
* extras/hbdoc/_gentxt.prg
* extras/hbdoc/_genxml.prg
* extras/hbdoc/hbdoc.hbp
* extras/hbdoc/hbdoc.prg
+ improve readability by paragraphs spacing in DESCRIPTION sections
+ improve divs in section content for better control via CSS
+ improve readability of tables with borders and
header hightlights
* change default output to single-file
+ add support for the old <table>/<fixed> tags in html output until they
are converted to something better
+ add support for <b>/<b>, <URL:url>, Markdown `inline code`,
_emphasis_, *bold*, character escaping \*, line separators ===/---,
and fenced code using triple backticks.
Very limited and not with standard compliance or completeness
in mind, just to be able to use some basic formatting.
; TODO: Markdown URL and lists, then replace all <b>,<URL>,<fixed>
markup with Markdown equivalents in docs
+ better localization support
+ add support for one file per component output via -output-component
cmdline option
% assemble output in memory and write to disk in a single call
% integrate external header
% replace almost all internal arrays with hashes
% replace self-modifying class and macro expansion with
regular hashes
% internal cleanups
% switch to simpler method for sort weighting
+ merge category/subcategory values into tag list. It
means they will be now be included in the output
% cleanup/fix/simplify value expansions for 'compliance',
'status' and 'platform' fields
% cleanup the way output engines are handles internally
+ add support for 'TAGS' entry to replace/extend the rigid and
ambiguous CATEGORY/SUBCATEGORY-based categorization. It is meant
to be a comma-separated list of freeform tags, possibly with a set
of standard common tags, with the freedom to use anything else deemed
useful by component/doc authors.
+ add footer showing the build date of the doc
+ include Git revision the doc is based on, link to the relevant
source tree version.
* various code refactoring steps to avoid unnecessary
classes, arrays, macro evaluation, and using undocumented
functions
% various HTML5 tag improvements and optimizations
+ load HBX file contents and lookup each referenced
symbol. Emit warning in verbose mode, if docs refers
to non-existing one.
(this replaces slow and broken logic based on hbextern.ch)
+ use core hbdoc API to load the documentation instead
of locally rolled logic
* always show those content problems that are considered
fatal and the input doc to be skipped
+ filter docs to English language by default
+ add ability to choose language using a command-line option
! fix faulty validation logic that resulted in
erronously skipping certain entries
+ identify docs' 'component' property automatically
! fix to not eat empty lines from examples
+ convert "see also" items to links (this works correctly only
in single file output mode)
! fix to not break words (f.e. URLs) when outputting HTML
% use shorter class names
! fix invalid element ID generated
! fix RTE when trying to create output by category
% delete dummy "HTML2" output mode
* convert more ASCII chars to better Unicode equivalents
+ mark more text as code automatically
* drop MS-DOS compatibility
* src/rtl/hbdoc.prg
! fix filling '_LANG' property with the correct value
* switch to use LF instead of CRLF in the field contents
* contrib/hbct/doc/en/*.txt
* contrib/hbgd/doc/en/hbgd.txt
* contrib/hbgt/doc/en/hbgt.txt
* contrib/hbmisc/doc/en/dates2.txt
* contrib/hbnf/doc/en/*.txt
* contrib/rddads/doc/en/adsfuncs.txt
* doc/en/*.txt
* cleanups and fixes
! casing
! fix to always delimit "see also" items with comma (",")
! fix various casing issues and old typos
! various fixes after detecting them using updated hbdoc
! eliminate/fix various rare/unnecessary/invalid field values
! move some embedded docs from hbdoc into their respective
doc sources
! fix a typo
* use backtick
* replace code copyright with reference to COPYING.txt (=LICENSE.txt)
+ mark tables without a header or with double height header
; Above patches come from 3.4 fork commits below:
2016-10-26 12:43 UTC+0200 Viktor Szakats (vszakats users.noreply.github.com)
2016-10-26 12:34 UTC+0200 Viktor Szakats (vszakats users.noreply.github.com)
2016-10-26 12:20 UTC+0200 Viktor Szakats (vszakats users.noreply.github.com)
2016-10-26 03:21 UTC+0200 Viktor Szakats (vszakats users.noreply.github.com)
2016-10-26 02:47 UTC+0200 Viktor Szakats (vszakats users.noreply.github.com)
2016-10-25 15:05 UTC+0200 Viktor Szakats (vszakats users.noreply.github.com)
2016-10-25 14:51 UTC+0200 Viktor Szakats (vszakats users.noreply.github.com)
2016-10-25 14:30 UTC+0200 Viktor Szakats (vszakats users.noreply.github.com)
2016-10-25 13:19 UTC+0200 Viktor Szakats (vszakats users.noreply.github.com)
2016-10-25 12:35 UTC+0200 Viktor Szakats (vszakats users.noreply.github.com)
2016-10-25 11:47 UTC+0200 Viktor Szakats (vszakats users.noreply.github.com)
2016-10-25 02:48 UTC+0200 Viktor Szakats (vszakats users.noreply.github.com)
2016-10-24 22:26 UTC+0200 Viktor Szakats (vszakats users.noreply.github.com)
2016-10-24 18:35 UTC+0200 Viktor Szakats (vszakats users.noreply.github.com)
2016-10-24 17:58 UTC+0200 Viktor Szakats (vszakats users.noreply.github.com)
2016-10-24 16:12 UTC+0200 Viktor Szakats (vszakats users.noreply.github.com)
2016-10-24 15:44 UTC+0200 Viktor Szakats (vszakats users.noreply.github.com)
2016-10-24 03:36 UTC+0200 Viktor Szakats (vszakats users.noreply.github.com)
2016-10-24 02:40 UTC+0200 Viktor Szakats (vszakats users.noreply.github.com)
2016-10-24 00:23 UTC+0200 Viktor Szakats (vszakats users.noreply.github.com)
2016-10-23 23:09 UTC+0200 Viktor Szakats (vszakats users.noreply.github.com)
2016-10-23 16:39 UTC+0200 Viktor Szakats (vszakats users.noreply.github.com)
2016-10-23 16:10 UTC+0200 Viktor Szakats (vszakats users.noreply.github.com)
2016-10-23 13:15 UTC+0200 Viktor Szakats (vszakats users.noreply.github.com)
179 lines
2.4 KiB
CSS
179 lines
2.4 KiB
CSS
body {
|
|
background-color: #f8f8f8;
|
|
font-family: 'Source Sans Pro', Arial, sans-serif;
|
|
font-size: 14pt;
|
|
line-height: 150%;
|
|
margin: 0;
|
|
padding: 0;
|
|
}
|
|
|
|
header {
|
|
-position: fixed;
|
|
top: 0;
|
|
background-color: #0974c5;
|
|
color: #f0f0f0;
|
|
border: none;
|
|
padding: 0 20px;
|
|
margin: 0;
|
|
}
|
|
|
|
footer {
|
|
background: #333;
|
|
color: #bbb;
|
|
font-size: 75%;
|
|
line-height: 150%;
|
|
margin: auto;
|
|
padding: .6em 1em;
|
|
height: 90px;
|
|
text-align: center;
|
|
width: auto;
|
|
}
|
|
|
|
footer a {
|
|
color: #ddd;
|
|
text-decoration: none;
|
|
}
|
|
|
|
footer a:hover {
|
|
border: none;
|
|
color: #f8f8f8;
|
|
transition: color .25s;
|
|
}
|
|
|
|
footer a:active {
|
|
color: #f8f8f8;
|
|
}
|
|
|
|
main {
|
|
margin: 0 10px;
|
|
}
|
|
|
|
main section:first-child {
|
|
-margin-top: 60px;
|
|
border-top: 0;
|
|
}
|
|
|
|
a {
|
|
text-decoration: none;
|
|
}
|
|
|
|
a:hover {
|
|
border-style: none none solid;
|
|
border-width: 0 0 1px;
|
|
border-color: #000088;
|
|
border-color: rgba(0, 0, 255, .4);
|
|
}
|
|
|
|
hr {
|
|
border: 0;
|
|
border-bottom: 1px dotted rgba(0, 0, 0, .1);
|
|
width: 75%;
|
|
margin-left: 0;
|
|
}
|
|
|
|
h1 {
|
|
font-size: 130%;
|
|
font-weight: normal;
|
|
padding: 14px 0;
|
|
margin: 0;
|
|
}
|
|
|
|
section {
|
|
border-top: 1px solid rgba(0, 0, 0, .1);
|
|
margin-top: 0;
|
|
margin-bottom: 0;
|
|
padding: 1em .6em;
|
|
}
|
|
|
|
h4 {
|
|
color: #095fa8;
|
|
font-size: 125%;
|
|
margin-top: 0;
|
|
margin-bottom: 14px;
|
|
}
|
|
|
|
pre {
|
|
background-color: #f2f2f2;
|
|
font-size: 12pt;
|
|
padding: 16px;
|
|
overflow: scroll;
|
|
}
|
|
|
|
pre, code, .d-t {
|
|
font-family: Hack, Consolas, Menlo, 'Droid Sans Mono', 'Source Code Pro', 'Liberation Mono', 'Oxygen Mono', 'Andale Mono', monospace;
|
|
}
|
|
|
|
code, .d-t {
|
|
font-size: 95%;
|
|
}
|
|
|
|
p {
|
|
margin-top: 1em;
|
|
margin-bottom: 1em;
|
|
}
|
|
|
|
.d-it div:first-child p {
|
|
margin-top: .2em;
|
|
}
|
|
|
|
.d-it div:last-child p {
|
|
margin-bottom: .2em;
|
|
}
|
|
|
|
.d-t {
|
|
border-top: 1px solid rgba(0, 0, 0, .1);
|
|
border-bottom: 1px solid rgba(0, 0, 0, .1);
|
|
overflow: scroll;
|
|
margin: 16px;
|
|
width: 80%;
|
|
}
|
|
|
|
.d-t1 div:first-child {
|
|
border-top: 0;
|
|
background-color: #333;
|
|
color: #f8f8f8;
|
|
}
|
|
|
|
.d-t2 div:nth-child(2) {
|
|
background-color: #333;
|
|
color: #f8f8f8;
|
|
}
|
|
|
|
.d-na {
|
|
font-size: 100%;
|
|
margin-left: 0;
|
|
padding-top: 0;
|
|
padding-bottom: 8px;
|
|
}
|
|
|
|
.d-ol {
|
|
font-weight: bold;
|
|
font-size: 115%;
|
|
margin-left: 1em;
|
|
margin-top: 0px;
|
|
margin-bottom: 14px;
|
|
}
|
|
|
|
.d-d {
|
|
color: #095fa8;
|
|
font-weight: bold;
|
|
margin-left: 0;
|
|
padding-top: 0;
|
|
padding-bottom: 8px;
|
|
}
|
|
|
|
.d-it {
|
|
margin-left: 1em;
|
|
padding-bottom: 8px;
|
|
}
|
|
|
|
.d-ex {
|
|
margin-left: 1em;
|
|
margin-right: 1em;
|
|
}
|
|
|
|
.d-te {
|
|
margin-left: 1em;
|
|
padding-bottom: 8px;
|
|
}
|