Custom Mallard XSLT

Shaun McCance shaunm at gnome.org
Sat Apr 16 19:43:40 UTC 2011


Hi all,

At Jim's request, I cooked up some XSLT/CSS customization for the
yelp-xsl Mallard stylesheets. These are designed to create HTML
that fits with the overall Ubuntu look for the web. Probably a
fair amount of work needs to be done yet to integrate this into
help.ubuntu.com. I don't know how to do that off-hand.

I've attached the customization. To use it, you should use the
yelp-build script in yelp-tools. You'll have to build that from
git. You should also get the latest yelp-xsl from git. Here's
instructions for installing to /usr. I know that's a generally
bad idea for non-package-management-controlled stuff, but this
is pretty safe.

git clone git://git.gnome.org/yelp-xsl
cd yelp-xsl
./autogen.sh --prefix=/usr
make
sudo make install

git clone git://git.gnome.org/yelp-tools
cd yelp-tools
./autogen.sh --prefix=/usr
make
sudo make install

Save the attached ubuntu.xsl somewhere. The directory with
the page files is as good a place as any. After getting the
Natty docs:

cd natty/gnome-help/C
yelp-build html -x ubuntu.xsl .

You can also mkdir an output directory and use -o to output
the files there. I think yelp-build still doesn't copy over
images correctly though, so you'll want to cp -R the figures
directory in.

--
Shaun

-------------- next part --------------
A non-text attachment was scrubbed...
Name: ubuntu.xsl
Type: application/xslt+xml
Size: 7817 bytes
Desc: not available
URL: <https://lists.ubuntu.com/archives/ubuntu-doc/attachments/20110416/a0fc1315/attachment.bin>


More information about the ubuntu-doc mailing list