Closed Martinsos closed 1 year ago
See also #122 and #44.
Maybe the documentation could be converted from (ancient) docbook
to (contemporary) reStructured Text
via pandoc
and then hosted on readthedocs.org
...
Slackware 15.0 (default full install) includes docbook
, but would require Sphinx
and its 10 dependencies if converted.
the happy webpage itself is HTML 3.2 code
temporary location of a 4.01 Transitional update
the User Guide files list generator as DocBook XSL Stylesheets
for Debian 11.1 the following might be indicated
docbook-xsl_1.79.2+dfsg-1_all.deb libxml2-utils_2.9.10+dfsg-6.7_amd64.deb (xmllint) xsltproc_1.1.34-4_amd64.deb
the configure script also makes a check for the presence of dblatex
for Slackware 15.0 after installing dblatex-0.3.10.tar.bz2
you may want to run updmap-user
to generate psfonts_t1.map and its symlink psfonts.map
I don't see why the number of additional dependencies in an unsaid Linux distribution should be an argument in this discussion. By extension, let's all switch from Haskell to C, because some Linux distribution has a C compiler by default, but no GHC.
The friction introduced by an ancient XML-based format like docbook is unthinkable by today's standards. Please, convert to something human-readable and editable, also having a modern UI, like readthedocs.
I tried conversion with pandoc
and hit:
$ pandoc -f docbook -t rst -s happy.xml
Invalid XML:
UnresolvedEntityException (fromList ["dollar","ldquo","mdash","percnt","rdquo"])
(This is now fixed in the master
of pandoc
.)
Thanks for taking this on @andreasabel ! Let me know if I can help in any way.
@andreasabel
happy.xml
dollar $
, ldquo “
, mdash —
, percnt %
, rdquo ”
alex.xml
$ ./pandoc -f docbook -t rst -s alex.xml
Invalid XML:
UnresolvedEntityException (fromList ["lsquo","nbsp","rsquo"])
$
lsquo ‘
, nbsp  
, rsquo ’
Upon typing
haskell happy
into search engine, first hit for me is haskell.org/happy, however the page doesn't seem to have been updated since 2010. This gives an impression that project stopped in 2010, which doesn't seem to be the case as I see here on github repo that there are new releases, latest one from 2020. Also, there is no link on the webpage that points to the github repo.While I understand that updating all information on the webpage might be a big task, would it be possible to at least update the "News" section with new releases, fix couple of broken links, and mention somewhere at the top that source is currently available on the github? If nothing else, at least we could put a note mentioning that the webpage is out of date and link to github repo.
I could make a PR, however I haven't seen code of the webpage being present in this repo. What is the method that could be used to propose a patch for the webpage? Thanks!