This is really about questions for Paul, but there were a few surprises for
me so I thought I would post this to the list just to share the knowledge.
In F10, we built the release notes from the xml, then copied the xml and
resulting html into the RPM. There were also a handful of associated
documents which sort of caught me by surprise.
My plan in F11 Preview is to pretty much follow the .spec file for F10, with
the exception that for the release notes proper I will do the Publican part
of the build inside the srpm. Given the timeline I don't think we are quite
ready to face the whole subpackage thing, although I'm not writing that off
for GA.
Some outstanding questions, mostly around gnome-help:
- What is up with the .omf files? Are they simply prepared manually and
included? What do they do? With my test document I can read the doc fine
with yelp and no omf files, in each of my 3 test languages
- What on earth is scrollkeeper and what does it do and why do we care?
- In gnome-help there are a handful of topics, one of which is release
notes. How did that get there? Hardcoded?
- You created symlinks for some images to avoid duplication. We have a
similar Publican issue, worth a little over 100K per language. Should we do
the same for F11?
- The whole copying business in the old .spec I found particularly hard to
follow. Although I kept the basic steps, I hacked up the appearance quite a
bit to make it more readable (to me). Here is a little snippet of the
relevant parts. Do you see any issues with this approach? (This is a test
document to make it run through Publican quicker)
# Loop through the languages
#
for LANG in tmp/* ; do
#
# First, the html in /usr/share/doc/HTML
#
# Place where html files are
SRCBASE=tmp/${LANG#tmp/}/html-desktop
# Target for release notes html
NOTETARG=$RPM_BUILD_ROOT%{_defaultdocdir}/HTML/%{name}/${LANG#tmp/}
mkdir -p ${NOTETARG}
install -m 644 ${SRCBASE}/index.html ${NOTETARG}/%{name}-${LANG#tmp/}.html
mkdir -p ${NOTETARG}/Common_Content
mkdir -p ${NOTETARG}/Common_Content/css
mkdir -p ${NOTETARG}/Common_Content/images
mkdir -p ${NOTETARG}/images
install -m 644 ${SRCBASE}/Common_Content/css/*
${NOTETARG}/Common_Content/css
install -m 644 ${SRCBASE}/Common_Content/images/*
${NOTETARG}/Common_Content/images
install -m 644 ${SRCBASE}/images/* ${NOTETARG}/images
#
# Now the gnome_help files
#
# Place where xml files are
SRCBASE=tmp/${LANG#tmp/}/xml
# gnome-help target for xml files
HELPTARG=$RPM_BUILD_ROOT%{_datadir}/gnome/help/%{name}/${LANG#tmp/}
mkdir -p ${HELPTARG}
mkdir -p ${HELPTARG}/Common_Content
mkdir -p ${HELPTARG}/images
install -m 644 ${SRCBASE}/images/* ${HELPTARG}/images
for F in ${SRCBASE}/Common_Content/*.xml ; do
install -m 644 ${F} ${HELPTARG}/Common_Content
done
mkdir -p ${HELPTARG}/Common_Content/css
install -m 644 ${SRCBASE}/Common_Content/css/*
${HELPTARG}/Common_Content/css
mkdir -p ${HELPTARG}/Common_Content/images
install -m 644 ${SRCBASE}/Common_Content/images/*
${HELPTARG}/Common_Content/images
for F in ${SRCBASE}/*.xml ; do
install -m 644 ${F} ${HELPTARG}/
done
done
--McD
--
fedora-docs-list mailing list
fedora-docs-list@xxxxxxxxxx
To unsubscribe:
https://www.redhat.com/mailman/listinfo/fedora-docs-list
