Re: XMLTO and SAXON
by Tommy Reynolds
Tim,
I've attached my saxon patch, too. It adds a new command line switch (-X
saxon) or (-X xsltproc), defaulting to what's in the
${XSLT_PROCESSOR} environment variable and if not set, to "xsltproc",
as usual.
Lemme know how this works out.
All you FDP lot can just ignore these patches for now. I've CC'ed
you just to let you know the patches have gone upstream.
Cheers
18 years, 6 months
Re: release-notes Makefile,1.1,1.2
by Karsten Wade
Tommy or Paul:
Can you look at this change and give us a better way to do it? Or am I
missing the existence of this functionality in Makefile.common?
thx - Karsten
On Mon, 2005-10-24 at 10:08 -0400, Karsten Wade wrote:
> Author: kwade
>
> Update of /cvs/docs/release-notes
> In directory cvs-int.fedora.redhat.com:/tmp/cvs-serv17937
>
> Modified Files:
> Makefile
> Log Message:
> Need to find a way to do this better, and I think it should be in the Makefile.common instead. However, my method here is obviously sub-par and throws an error, so I'll be punting for help. The objective is to make certain that the figs/ directory gets copied over to the HTML directories in all languages. Actually, the figs-/ needs to get copied to foo-/ HTML directory. This requires some consideration and kung-fu. It should copy over the language specific figures if they exist, otherwise use the English by default so as to not break the build.
>
>
> Index: Makefile
> ===================================================================
> RCS file: /cvs/docs/release-notes/Makefile,v
> retrieving revision 1.1
> retrieving revision 1.2
> diff -u -r1.1 -r1.2
> --- Makefile 24 Oct 2005 13:13:33 -0000 1.1
> +++ Makefile 24 Oct 2005 14:08:53 -0000 1.2
> @@ -1,90 +1,100 @@
> -LANG = en
> -DOCS_SETUP_PATH= ../../docs-common
> -XSLPDF = $(DOCS_SETUP_PATH)/xsl/main-pdf.xsl
> -XSLHTML = $(DOCS_SETUP_PATH)/xsl/main-html-nochunks-relnotes.xsl
> -
> -XSLPDFCOMMONS = ${XSLPDF}
> -XSLHTMLCOMMONS = ${XSLHTML}
> -
> -XMLCOMMONSPATH=${DOCS_SETUP_PATH}/common
> -XMLCOMMONS=${XMLCOMMONSPATH}/cvs-en.xml \
> - ${XMLCOMMONSPATH}/draftnotice-en.xml \
> - ${XMLCOMMONSPATH}/fedora-entities-en.ent \
> - ${XMLCOMMONSPATH}/fedora-entities-en.xml \
> - ${XMLCOMMONSPATH}/legacynotice-en.xml \
> - ${XMLCOMMONSPATH}/legalnotice-en.xml \
> - ${XMLCOMMONSPATH}/obsoletenotice-en.xml
> -
> -.SUFFIXES:
> -.SUFFIXES: .html .pdf .xml
> -
> -all: README-${LANG}.html \
> - RELEASE-NOTES-${LANG}.html \
> - RELEASE-NOTES-${LANG}.txt \
> - README-${LANG}.txt
> -
> -#README-${LANG}.pdf RELEASE-NOTES-${LANG}.pdf
> -
> -%.pdf: %.xml
> - xmlto pdf -x ${XSLPDF} $<
> -
> -%.html: %.xml
> - ${RM} -r ${@:.html=}
> - xmlto html -x ${XSLHTML} -o ${@:.html=} $<
> - mkdir -p ${@:.html=}/stylesheet-images
> - mkdir -p ${@:.html=}/figs
> - cp $(DOCS_SETUP_PATH)/stylesheet-images/*.png ${@:.html=}/stylesheet-images
> - cp ./figs/*.png ${@:.html=}/figs
> - cp $(DOCS_SETUP_PATH)/css/fedora.css ${@:.html=}
> - mv ${@:.html=}/${@:.html=.proc} ${@:.html=}/$@
> - ln -sf ${@:.html=}/$@ $@
> -
> -%.txt: %.xml
> - xmlto txt $<
> -# mv $@ RELEASE-NOTES-${LANG}
> -
> -# FIXME eula.txt: eula.py
> -# FIXME python -c "import py_compile; py_compile.compile('eula.py')"
> -
> -# Note: keep "RELEASE-NOTES-en.xml" first, for now.
> -
> -RNFILES=RELEASE-NOTES-en.xml daemons.xml database-servers.xml \
> - desktop.xml development-tools.xml feedback.xml file-servers.xml \
> - file-systems.xml hardware-reqs.xml install-notes.xml intro.xml \
> - java-package.xml kernel.xml misc-server.xml multimedia.xml \
> - networking.xml overview.xml package-movement.xml \
> - package-notes.xml printing.xml project-overview.xml samba.xml \
> - security.xml server-tools.xml splash.xml web-servers.xml \
> - xorg.xml
> -
> -# README-${LANG}.pdf: README-en.xml
> -# README-${LANG}.html: README-en.xml
> -RELEASE-NOTES-${LANG}.pdf: ${RNFILES} ${XMLCOMMONS} ${XSLPDFCOMMONS}
> -RELEASE-NOTES-${LANG}.html: ${RNFILES} ${XMLCOMMONS} ${XSLHTMLCOMMONS}
> -RELEASE-NOTES-${LANG}.txt: ${RNFILES} ${XMLCOMMONS}
> -
> -clean:
> - ${RM} ChangeLog ChangeLog.xml
> -
> -distclean clobber: clean
> - ${RM} ChangeLog-${LANG}.html ChangeLog.txt
> - ${RM} -r README-${LANG}.pdf README-${LANG}.html README-${LANG}.txt
> - ${RM} -r RELEASE-NOTES-${LANG}.pdf RELEASE-NOTES-${LANG}.html \
> - RELEASE-NOTES-${LANG} RELEASE-NOTES-${LANG}.txt
> -
> -# If you have the "cvs2cl" package installed, then you can make
> -# fancy HTML ChangeLogs
> -
> -ChangeLogs:
> - ${RM} ChangeLog*
> - ${MAKE} ChangeLog.txt
> - ${MAKE} ChangeLog-${LANG}.html
> -
> -ChangeLog.txt:
> - LANG=C cvs2cl -f ChangeLog.txt
> -
> -ChangeLog.xml:
> - LANG=C cvs2cl --xml --xml-encoding UTF-8 -f ChangeLog.xml
> -
> -ChangeLog-${LANG}.html: ChangeLog.xml
> - xsltproc -o $@ /usr/share/xml/cvs2cl/cl2html.xslt $<
> +###############################################################################
> +# Makefile for RHLP docs project
> +# Created by: Tammy Fox <tfox(a)redhat.com>
> +# Last edited by: Tommy Reynolds <Tommy.Reynolds(a)MegaCoder.com>
> +# WARNING: need passivetex 1.24 for pdf generation to work
> +# License: GPL
> +# Copyright 2003 Tammy Fox, Red Hat, Inc.
> +# Copyright 2005 Tommy Reynolds, MegaCoder.com
> +###############################################################################
> +#
> +# Document-specific definitions.
> +#
> +LANGUAGES = en
> +DOCBASE = RELEASE-NOTES
> +XMLEXTRAFILES-en=daemons.xml database-servers.xml desktop.xml development-tools.xml feedback.xml file-servers.xml file-systems.xml hardware-reqs.xml install-notes.xml intro.xml java-package.xml kernel.xml misc-server.xml multimedia.xml networking.xml overview.xml package-movement.xml package-notes.xml printing.xml project-overview.xml samba.xml security.xml server-tools.xml splash.xml web-servers.xml xorg.xml
> +#
> +######################################################
> +include ../docs-common/Makefile.common
> +######################################################
> +#
> +# If you want to add additional steps to any of the
> +# targets defined in "Makefile.common", be sure to use
> +# a double-colon in your rule here. For example, to
> +# print the message "FINISHED AT LAST" after building
> +# the HTML document version, uncomment the following
> +# line:
> +#${DOCBASE}-en/index.html::
> +# echo FINISHED AT LAST
> +
> +# Need to copy over the figures for this directory. Should
> +# this be a common action instead?
> +${DOCBASE}-en/index.html::
> + mkdir -p ${DOCBASE}-${LANGUAGES}/figs
> + cp figs/* ${DOCBASE}-${LANGUAGES}/figs
> +
> +######################################################
> +# Some packaging specific vars
> +VERSION=$(shell grep BOOKID $(DOCBASE)-en.xml | sed 's/<!ENTITY BOOKID "[^0-9\.]\+//' | sed 's/ .\+//')
> +DATE=${shell grep BOOKID $(DOCBASE)-en.xml | sed 's/.\+(//' | sed 's/).\+//' }
> +NOW=$(shell date +"%a %b %e %Y")
> +SPECIN=../docs-common/packaging/fedora-doc.spec.in.common
> +OMFIN=../docs-common/packaging/fedora-doc.omf.in.common
> +DESKTOPIN=../docs-common/packaging/fedora-doc.desktop.in.common
> +DOCSPEC=$(PWD)/SPECS/$(DOCBASE).spec
> +DOCOMF=$(PWD)/SOURCES/fedora-doc-$(DOCBASE)-C.omf
> +DOCDESKTOP=$(PWD)/SOURCES/fedora-doc-$(DOCBASE).desktop
> +DOCSRCTAR=$(PWD)/SOURCES/$(DOCBASE)-$(VERSION).src.tar.gz
> +TITLE=$(shell ../docs-common/packaging/titlegrab.py $(DOCBASE)-en.xml | sed 's/^ \+//')
> +######################################################
> +# Some RPM flags...
> +######################################################
> +RPMFLAGS=--define "docbase $(DOCBASE)" --define "version $(VERSION)" --define "_topdir $(PWD)"
> +######################################################
> +
> +
> +clean::
> + rm -rf fedora-doc-$(DOCBASE)*.rpm
> +
> +
> +rpm: clean
> +#
> +# Make RPM-compliant tarball of source XML and other stuff
> + mkdir $(DOCBASE)-$(VERSION)
> + find . -maxdepth 1 -type f ! \( -name '*~' -o -name 'Makefile*' \) \
> + | cpio -pamdv $(DOCBASE)-$(VERSION)
> + find . -maxdepth 1 -type d ! \( -name '$(DOCBASE)-$(VERSION)' \
> + -o -name 'CVS' -o -name '*~' -o -name '$(DOCBASE)*' \) \
> + | cpio -pamdv $(DOCBASE)-$(VERSION)
> +#
> +# Make RPM build tree; don't rely on local user's setup
> + mkdir -p {BUILD,RPMS/noarch,SOURCES,SPECS,SRPMS}
> + tar -zcvf $(DOCSRCTAR) $(DOCBASE)-$(VERSION)
> + rm -rf $(DOCBASE)-$(VERSION)/
> +#
> +# Make rpmlint happy with a changelog entry
> +# FIXME: Maybe more magic would make this stickier; pity
> +# I'm no magician...
> + sed 's/\(%changelog\)/\1\n* $(NOW) Fedora Docs Project <fedora-docs-list(a)redhat.com> - $(VERSION)-1\n- Update to version $(VERSION)\n/' \
> + $(SPECIN) > $(DOCSPEC)
> +#
> +# Fill in files
> +# FIXME: Needs to be multiplexed for LANGUAGES (see above)
> + cp $(OMFIN) $(DOCOMF)
> + cp $(DESKTOPIN) $(DOCDESKTOP)
> + sed -i 's/@VERSION@/$(VERSION)/g' $(DOCOMF)
> + sed -i 's/@DATE@/$(DATE)/g' $(DOCOMF)
> + sed -i 's/@TITLE@/$(TITLE)/g' $(DOCOMF)
> + sed -i 's/@DOCBASE@/$(DOCBASE)/g' $(DOCOMF)
> + sed -i 's/@VERSION@/$(VERSION)/g' $(DOCDESKTOP)
> + sed -i 's/@DATE@/$(DATE)/g' $(DOCDESKTOP)
> + sed -i 's/@TITLE@/$(TITLE)/g' $(DOCDESKTOP)
> + sed -i 's/@DOCBASE@/$(DOCBASE)/g' $(DOCDESKTOP)
> +#
> +# Do the build...
> +#
> + rpmbuild -bb $(RPMFLAGS) $(DOCSPEC)
> + mv RPMS/noarch/*.rpm .
> + rpmbuild --clean --rmsource $(RPMFLAGS) $(DOCSPEC)
> + rm -rf {BUILD,RPMS,SOURCES,SPECS,SRPMS}
> + rm -rf $(DOCBASE)-$(VERSION)
>
> --
> Fedora-docs-commits mailing list
> Fedora-docs-commits(a)redhat.com
> https://www.redhat.com/mailman/listinfo/fedora-docs-commits
--
Karsten Wade, RHCE * Sr. Tech Writer * http://people.redhat.com/kwade/
gpg fingerprint: 2680 DBFD D968 3141 0115 5F1B D992 0E06 AD0E 0C41
Red Hat SELinux Guide
http://www.redhat.com/docs/manuals/enterprise/RHEL-4-Manual/selinux-guide/
18 years, 6 months
invitation to hack the relnotes tonight
by Karsten Wade
I was unable to work on the relnotes this weekend, and we have had a
temporary staffing shortage for the release notes team. For both of
these reasons, I have extended the freeze for translation by seven
hours, to give me time to sweep the relnotes together for trans for FC5
test1.
Highlights:
* Patrick did some tricky coolness to get us Wiki > XML, gracias
* First pull from Wiki beats into relnotes
* New structure in CVS
If you are interested in this, I'll be on #fedora-docs working on this
starting after Midnight UTC (25 October).
- Karsten
--
Karsten Wade, RHCE * Sr. Tech Writer * http://people.redhat.com/kwade/
gpg fingerprint: 2680 DBFD D968 3141 0115 5F1B D992 0E06 AD0E 0C41
Red Hat SELinux Guide
http://www.redhat.com/docs/manuals/enterprise/RHEL-4-Manual/selinux-guide/
18 years, 6 months
establishing a timezone for FDP
by Karsten Wade
There are two reasons I use Eastern Daylight/Standard time:
* That is where the QA and release engineering teams for Fedora are
primarily based. Working off a schedule that is intuitive for them
reduces the chances of miscommunication and mistakes.
* The same intuitiveness is currently spread throughout the Fedora
development community.
Should this change, or we want to lead a charge for UTC on all things,
feel free to challenge this concept.
Meanwhile, if we ever set a deadline, e.g. 24 October, this is what it
means:
24 October 23:59 Eastern Time
Yes, that means right before Midnight. This way we provide the most
time for completing deadlines without having confusion about Midnight
meaning the start of the end of which day.
Alternately, we can set deadlines as COB (close of business), for an
additional cushion of time. That would be:
24 October 17:00 Easter Time
Does this make sense?
When doing the scheduling for translation, I tried to add in a calendar
day as a cushion against any problems caused by a deadline being late
afternoon in APAC.
http://fedoraproject.org/wiki/DocsProject/Schedule
- Karsten
--
Karsten Wade, RHCE * Sr. Tech Writer * http://people.redhat.com/kwade/
gpg fingerprint: 2680 DBFD D968 3141 0115 5F1B D992 0E06 AD0E 0C41
Red Hat SELinux Guide
http://www.redhat.com/docs/manuals/enterprise/RHEL-4-Manual/selinux-guide/
18 years, 6 months
Self-Introduction: Yuan Yijun
by Yuan Yijun
Name: Yuan Yijun (袁乙钧, in Chinese)
City & Country: Shenzhen, Guangdong, China (tz: +0800)
Profession: Programmer
Company: Morningstar, Inc.
Your goals in the Fedora Project
- I want to help document translation. I want to see more Chinese
documents in fedora.
Historical qualifications
- I contributed some translations to Chinese Man Page Project
(http://cmpp.linuxforum.net ), include bash.1, etc.
- I'm working on http://fedora.gro.clinux.org
Computer skills
- I'm a linux user since redhat 7.3.
- I will become a excellent c++ programmer.
GPG KEYID and fingerprint
pub 1024D/83349285 2005-10-22 [expires: 2007-01-01]
Key fingerprint = DCCE E98A DBBC 71F6 57D8 C2BA CF7A 52BD 8334 9285
uid Yuan Yijun (bbbush) <bbbush.yuan(a)gmail.com>
sub 2048g/CDB2236B 2005-10-22 [expires: 2007-01-01]
--
bbbush ^_^
18 years, 6 months
Self-Introduction: Hrishikesh Ballal
by Hrishikesh Ballal
Name: Hrishikesh Ballal
Location: Eastern Time Zone, USA
Profession: Process Specialist
Your goals in the Fedora Project
I wish to contribute to the web / infrastructure team. I have
intermediate coding skills and am looking to contribute with the website
and other web related backend systems.
Historical qualifications
What other projects or writing have you worked on in the past?
- I have worked on the new design on www.fedoraproject.org website, wiki
and other components of the website including Fedora Accounts System.
- I have worked with Yumex with some documentation and am currently
helping the project with testing and optimization.
- I am currently working on www.fedoratracker.org
Anything else special?
Nope. Everything else is at
http://www.hrishikeshballal.net/
http://www.fedoraproject.org/wiki/HrishikeshBallal
What level and type of computer skills do you have?
As far as Fedora is concerned, I have intermediate coding skills in
Python, PHP, SQL.
What other skills do you have that might be applicable? User interface
design, other so-called soft skills (people skills), programming, etc.
I have project management and project planning skills. Professionally, I
am involved in optimizing IT systems and processes. I have experience in
process control, optimization and feedback systems.
GPG KeyID and Fingerprint
pub 1024D/DECEE55D 2005-06-16
Key fingerprint = D2F7 2117 6C27 519A 3FA3 A2C5 5934 5083 DECE
E55D
uid Hrishikesh Ballal <hballal(a)gmail.com>
sub 1024g/CE27A608 2005-06-16
18 years, 6 months
Fedora web team
by Elliot Lee
Hey all,
It seems like there are at least a few people who are interested in
reworking the Fedora web site. I think it would be good to have more
coordination on our efforts. So, please visit:
http://fedoraproject.org/wiki/Fedora/Web
and let's all get together and figure things out.
This may just be my way of catching up with everyone else who is already
working nicely together - please bring me up to speed. :)
Best,
-- Elliot
18 years, 6 months
