> On June 17, 2016, 1:14 a.m., Michael Pyne wrote:
> > Regarding the alternative stylesheets, I don't think that's possible.
> > However I've been able to approximate the effect. The KDE Docbook
> > stylesheets use a '`kde.common`' parameter as the base URL for the HTML
> > resources. While it defaults to using kio_help, you can point it to a
> > separate directory (which should contains the contents of "$(kf5-config
> > --install data)/doc/HTML/$LANG/kdoctools5-common").
> >
> > You would then use the `--param` option to `meinproc5` to set `kde.common`.
> > Here's the script I used to use to build kdesrc-build docs (before simply
> > sending users to the docs.kde.org docs). You might experiment with
> > stylesheets other than kde-chunk-online.xsl:
> >
> > #!/bin/sh
> > # build-docs
> >
> > # We need to run this from right directory, i.e. the director we want
> > generated
> > # output to go to.
> >
> > PATH_TO_DOCS="../doc/index.docbook"
> > COMMON_DIR="kdoctools5-common"
> > COMMON_FILES=$(printf "'%s/'" "$COMMON_DIR") # The single quotes are
> > exceedingly important
> >
> > DATA_DIR=$(kf5-config --install data)
> > DATA_DIR=${DATA_DIR%/} # Remove trailing /
> >
> > DOC_SRCDIR="$DATA_DIR/kf5/kdoctools"
> > XSLT="$DOC_SRCDIR/customization/kde-chunk-online.xsl"
> >
> > if [ ! -e "$COMMON_DIR" ]; then
> > ln -s "$DATA_DIR/doc/HTML/en/$COMMON_DIR" .
> > fi
> >
> > meinproc5 --srcdir "$DOC_SRCDIR" \
> > --param kde.common="$COMMON_FILES" \
> > --stylesheet "$XSLT" \
> > "$PATH_TO_DOCS"
Thanks for the information, need to take a look at this then.
- Christoph
-----------------------------------------------------------
This is an automatically generated e-mail. To reply, visit:
https://git.reviewboard.kde.org/r/128213/#review96619
-----------------------------------------------------------
On June 16, 2016, 4:43 p.m., Christoph Cullmann wrote:
>
> -----------------------------------------------------------
> This is an automatically generated e-mail. To reply, visit:
> https://git.reviewboard.kde.org/r/128213/
> -----------------------------------------------------------
>
> (Updated June 16, 2016, 4:43 p.m.)
>
>
> Review request for KDE Frameworks and Luigi Toscano.
>
>
> Repository: kdoctools
>
>
> Description
> -------
>
> Fix the optional HTML documentation generation (which I would like to use for
> Windows/Mac)
>
> Sidenote: The goal would be to have some html which can be used without
> khelpcenter and the help:/ ioslave.
> Is there some other stylesheet one could use for that?
>
>
> Diffs
> -----
>
> KF5DocToolsMacros.cmake e0a85b3
>
> Diff: https://git.reviewboard.kde.org/r/128213/diff/
>
>
> Testing
> -------
>
> Before this patch: if you turn HTML docs on, not even cmake will complete, as
> the target names are broken.
> Now: make && make install for e.g. kate.git will create & install a
> index.html if HTML docs are turned on.
>
>
> Thanks,
>
> Christoph Cullmann
>
>
_______________________________________________
Kde-frameworks-devel mailing list
Kde-frameworks-devel@kde.org
https://mail.kde.org/mailman/listinfo/kde-frameworks-devel
