docs November 2005

docs@lists.fedoraproject.org

23 participants
32 discussions

Minutes of FDSCo meeting 22 Nov 2005
by Stuart Ellis 23 Nov '05

23 Nov '05

Attending: --------- quaid elliss G2 megacoder mrj stickster Regrets: -------- Tammy Fox (tcf) - leave of absence Schedule of Tasks: ------------------ http://www.fedoraproject.org/wiki/DocsProject/FedoraDocsSchedule Highlights: ----------- * Release Notes: Great job done by Release Note beat writers and translators. Release Notes for FC5t1 have finalised and will be available in five languages. * DocsRawhide: Maintained documents in CVS are now built into Webpages, updated every hour. To avoid potential confusion about the status of the documents, public access to the site will be restricted until alternate stylesheets are in place to visibly distinguish the Rawhide drafts from completed documents. * Packaging: Work is ongoing to enhance the Fedora document build infrastructure to create RPMs for shipping documentation. Technical issues are being discussed on the main mailing list (fedora-docs-list) as they arise. Anyone with a interest in this area is welcome to join in and add their input. -- Stuart Ellis stuart(a)elsn.org Fedora Documentation Project: http://fedora.redhat.com/projects/docs/ GPG key ID: 7098ABEA GPG key fingerprint: 68B0 E291 FB19 C845 E60E 9569 292E E365 7098 ABEA

1 0

Proposal for document entities
by Paul W. Frields 21 Nov '05

21 Nov '05

Currently, our documents have entities like this (please pardon the MUA mangling): <!ENTITY % FEDORA-ENTITIES-EN SYSTEM "../docs-common/common/fedora-entities-en.ent"> %FEDORA-ENTITIES-EN; <!ENTITY BOOKID "foo-tutorial-0.15 (2005-01-01)">  I would like to see this instead as a standard: <!ENTITY BOOKNAME "foo-tutorial"> <!ENTITY BOOKVERSION "0.15">  <!ENTITY BOOKDATE "2005-01-01">  <!ENTITY BOOKID "&BOOKNAME;-&BOOKVERSION; (&BOOKDATE;)"> <!ENTITY BUG-NUM "000000">  Any input? -- Paul W. Frields, RHCE http://paul.frields.org/ gpg fingerprint: 3DA6 A0AC 6D58 FEC4 0233 5906 ACDB C937 BD11 3717 Fedora Documentation Project: http://fedora.redhat.com/projects/docs/

4 5

Re: docs-common/common legalnotice-relnotes-zh_CN.xml,NONE,1.1
by Karsten Wade 21 Nov '05

21 Nov '05

On Mon, 2005-11-21 at 11:18 +0800, Yuan Yijun wrote: > Should I update the master file (RELEASE-NOTES-zh_CN.xml) or I could > do that until next freeze? How does it need updating? - Karsten -- Karsten Wade, RHCE * Sr. Tech Writer * http://people.redhat.com/kwade/ gpg fingerprint: 2680 DBFD D968 3141 0115 5F1B D992 0E06 AD0E 0C41 Content Services Fedora Documentation Project http://www.redhat.com/docs http://fedoraproject.org/wiki/DocsProject

2 1

[Fwd: Fedora general improvements input survey invitation]
by Karsten Wade 19 Nov '05

19 Nov '05

For those who might not have seen this ... Please participate. Surveys like this can be very valuable. -------- Forwarded Message -------- > From: Tim Burke <tburke(a)redhat.com> > Reply-To: Development discussions related to Fedora Core <fedora- > devel-list(a)redhat.com> > To: fedora-devel-list(a)redhat.com, fedora-test-list(a)redhat.com, fedora- > extras-list(a)redhat.com, fedora-maintainers(a)redhat.com > Subject: Fedora general improvements input survey invitation > Date: Thu, 17 Nov 2005 21:23:25 -0500 > The Fedora Core team invites you to participate in a survey to help > identify the major ways in which Fedora can be improved for the benefit > of the community. The survey consists of 10 questions involving Fedora > Core and Fedora Extras. We are greatly interested in your views and > hope you can share your thoughts with us. The survey is available at: > > http://www.keysurvey.com/survey/85928/1078/ > > The survey is enabled now and will remain open for input until > Wednesday, November 30. > > Thanks in advance for helping us to make Fedora better for all > involved. Upon conclusion of the survey, a summary of the results will > be shared. > > -- Karsten Wade, RHCE * Sr. Tech Writer * http://people.redhat.com/kwade/ gpg fingerprint: 2680 DBFD D968 3141 0115 5F1B D992 0E06 AD0E 0C41 Content Services Fedora Documentation Project http://www.redhat.com/docs http://fedoraproject.org/wiki/DocsProject

1 0

wow, release notes
by Karsten Wade 19 Nov '05

19 Nov '05

This morning I came in to run the final build of the test1 release notes. It is beautiful. Five languages in one CVS with one Makefile to rule them all. And this was done the hard way! Imagine when we integrate the documentation XML into the same workbench system that is used for translating the strings in Fedora applications. Thanks to all involved for your help. I'll send a proper announcement and appreciation to the test list following the release of test1. You'll notice that the content is the same across the original English and the translated release notes (Italian, Japanese, Russian, and Simplified Chinese). To do this, we had to freeze the content and give it time to be translated. An updated release notes with content that is currently in the Wiki *will be* available when test1 is released. Once I have tagged this content in CVS, it will freeze again for a while. If anyone wants to update their translation, you can do so during that freeze. I will see that the updated version is posted to http://fedora.redhat.com/docs/release-notes/ as soon as possible. Cheers - Karsten -- Karsten Wade, RHCE * Sr. Tech Writer * http://people.redhat.com/kwade/ gpg fingerprint: 2680 DBFD D968 3141 0115 5F1B D992 0E06 AD0E 0C41 Content Services Fedora Documentation Project http://www.redhat.com/docs http://fedoraproject.org/wiki/DocsProject

1 0

make on older systems (RHEL3)
by Patrick W. Barnes 18 Nov '05

18 Nov '05

I've made some revisions to docs-common/Makefile.common in an attempt to resolve build failures on RHEL3. I'd like this to undergo more testing (particularly on older systems) before committing it. In particular, I would like Tommy to take a quick look at this to make sure it doesn't break anything. It is a syntax change that, to the best of my knowledge, shouldn't change behavior, but I'm not overly experienced with Makefiles. The altered file is attached. -- Patrick "The N-Man" Barnes nman64(a)n-man.com www.n-man.com -- ######################################################################### # Makefile.common # # This file, to be included from every document's local Makefile, provides # the basic targets used by the Fedora Docs Project: # all -- Default target, builds HTML document only # ${DOCNAME}/index.html -- Builds HTML version of document # html -- See "${DOCNAME}/index.html" # html-nochunks -- See "${DOCNAME}.html"; single HTML file # ${DOCNAME}.tar.gz -- Packages HTML document into a tar archive # tarball -- See "${DOCNAME}.tar.gz" # clean -- Deletes all generated files and directories # distclean -- See "clean" # ${DOCNAME}.pdf -- Builds PDF version of document # pdf -- See "${DOCNAME}.pdf" ######################################################################### # PDF generation is still fragile and probably won't work on your document. # Yet. ######################################################################### # Note: all targets within this Makefile.common must be defined as # double-colon (::) targets so that additional steps can be added by # providing additional rules, also marked with double-colons, in the # document Makefile. ######################################################################### # Allow client document to provide "Make.paths" file to locate our files # This is a "silent include", so if it's missing there is no problem. # This file, if present, must be in the DOCUMENT directory, not here in # docs-common. Even if this file is present, defining FTPDIR via the # command line will take precedence. sinclude Make.paths ######################################################################### # Supply default values for the boilerplate files _unless_ the user has # provided their own values. ifeq (${FDPDIR},) FDPDIR = .. endif ifeq (${XSLPDF},) XSLPDF = ${FDPDIR}/docs-common/xsl/main-pdf.xsl endif ifeq (${XSLHTML},) XSLHTML = ${FDPDIR}/docs-common/xsl/main-html.xsl endif ifeq (${XSHTMLNOCHUNKS},) XSLHTMLNOCHUNKS = ${FDPDIR}/docs-common/xsl/main-html-nochunks.xsl endif ######################################################################### # Define a macro to locate xmlto(1) so we can choose a specific version # by "make XMLTO=/path/to/xmlto", if we so desire. XMLTO =xmlto ######################################################################### # PUT NO TARGETS BEFORE THIS ONE, not even in your base Makefile # In a properly-constructed Makefile, this will be the default target TARGETS=all tarball pdf html html-nochunks clean distclean showvars .PHONY: ${TARGETS} all:: html html-nochunks tarball # pdf ${TARGETS}:: ######################################################################### # For each LANG in LANGUAGES, generate a target and rule similar to: # mydoc-en/index.html:: mydoc-en.xml ${XMLEXTRAFILES}-en # LANG=en.UTF-8 ${XMLTO} html -x $(XSLHTML) -o mydoc-en mydoc-en.xml # mkdir -p mydoc-en/stylesheet-images # cp ${FDPDIR}/docs-common/stylesheet-images/*.png mydoc-en/stylesheet-images/ # cp ${FDPDIR}/docs-common/css/fedora.css mydoc-en/ # mkdir -p mydoc-en/figs # cp -p figs/*-${LANG}.* mydoc-en/figs # but we do avoid copying EPS files since they are nonsense to the HTML world. # Also, we create the figs directory only if the document dir has a "figs/". # I don't think we need to do this for a nochunks output, though. # define HTML_template ${DOCBASE}-$(1)/index.html:: ${DOCBASE}-$(1).xml $$(XMLEXTRAFILES-$(1)) LANG=$(1).UTF-8 ${XMLTO} html -x $(XSLHTML) -o $(DOCBASE)-$(1) $(DOCBASE)-$(1).xml mkdir -p $(DOCBASE)-$(1)/stylesheet-images/ cp ${FDPDIR}/docs-common/stylesheet-images/*.png $(DOCBASE)-$(1)/stylesheet-images cp ${FDPDIR}/docs-common/css/fedora.css $$(DOCBASE)-$(1)/ [ ! -d figs ] || ( \ mkdir -p ${DOCBASE}-$(1)/figs; \ find figs -type f -iname '*.*' -print | \ egrep -vi '*.eps' | \ egrep '(.*-$(1)..*)|([^-]*[.][^-]*)' | \ while read x; do cp -f $$$${x} ${DOCBASE}-$(1)/figs; done \ ) && exit 0 endef # html:: $(DOCBASE)-$(LANGUAGES)/index.html $(DOCBASE)-$(LANGUAGES)/index.html:: $(foreach LANG,${LANGUAGES},$(eval $(call HTML_template,${LANG}))) # ######################################################################### # For each language in ${LANGUAGES}, generate a single HTML file define HTMLNOCHUNK_template ${DOCBASE}-$(1).html:: ${DOCBASE}-$(1).xml $$(XMLEXTRAFILES-$(1)) ${XMLTO} html-nochunks -x $(XSLHTMLNOCHUNKS) $(DOCBASE)-$(1).xml mkdir -p stylesheet-images/ cp ${FDPDIR}/docs-common/stylesheet-images/*.png stylesheet-images/ cp ${FDPDIR}/docs-common/css/fedora.css . endef # html-nochunks:: $(DOCBASE)-$(LANGUAGES).html $(DOCBASE)-$(LANGUAGES).html:: $(foreach LANG,${LANGUAGES},$(eval $(call HTMLNOCHUNK_template,${LANG}))) # ######################################################################### # For each language in ${LANGUAGES}, build a tarball of the HTML files. # define TAR_template ${DOCBASE}-$(1).tar.gz:: ${DOCBASE}-$(1)/index.html tar -zc --exclude '*.eps' -f ${DOCBASE}-$(1).tar.gz ${DOCBASE}-$(1) endef # tarball:: $(DOCBASE)-$(LANGUAGES).tar.gz $(DOCBASE)-$(LANGUAGES).tar.gz:: $(foreach LANG,${LANGUAGES},$(eval $(call TAR_template,${LANG}))) # ######################################################################### # For each language in ${LANGUAGES}, generate an Adobe Portable Document # Format (PDF) file. define PDF_template ${DOCBASE}-$(1).pdf:: ${DOCBASE}-$(1).xml $$(XMLEXTRAFILES-$(1)) ${XMLTO} pdf -x $(XSLPDF) $(DOCBASE)-$(1).xml endef # pdf:: $(DOCBASE)-$(LANGUAGES).pdf $(DOCBASE)-$(LANGUAGES).pdf:: $(foreach LANG,${LANGUAGES},$(eval $(call PDF_template,${LANG}))) # ######################################################################### # For each language in ${LANGUAGES}, clean up! define CLEAN_template ${DOCBASE}-$(1)-clean:: ${RM} -r ${DOCBASE}-$(1) ${RM} -r ${DOCBASE}-$(1).html stylesheet-images fedora.css ${RM} -r ${DOCBASE}-$(1).pdf ${RM} -r ${DOCBASE}-$(1).tar.gz endef # distclean clean:: ${DOCBASE}-${LANGUAGES}-clean ${DOCBASE}-${LANGUAGES}-clean:: $(foreach LANG,${LANGUAGES},$(eval $(call CLEAN_template,${LANG}))) showvars:: @echo "DOCBASE=\"$(DOCBASE)\"" @echo "LANGUAGES=\"$(LANGUAGES)\"" # ######################################################################### # End of Makefile.common #########################################################################

2 2

Rawhide of Docs
by Elliot Lee 18 Nov '05

18 Nov '05

If you'd like to see the latest and greatest docs that that the Fedora Documentation team has been working on, you can now visit http://webtest.fedora.redhat.com/docs/ Join the fun! -- Elliot

3 2

RPM Guide in odt format
by Serge.Sterck＠fmsb.be 17 Nov '05

17 Nov '05

1 0

Re: Done translating: FC4 Training Material
by Fajar Priyanto 17 Nov '05

17 Nov '05

On Wednesday 09 November 2005 01:54 pm, Fajar Priyanto wrote: > > An English-language resource on Fedora Core would be most helpful to me, > > as I try to introduce Linux in the broader community of computer users. > > I'll translate it ASAP, along with some revisions already in my mind. The > hardest thing is to have enough strength to do it. Because I am a commuter > that have to take a 70km journey everyday to the office by car. Actually it > isn't so bad if the toll road is not so congested everyday. Ups, looks > like I've been ranting. Ok see you, Hi all, I have finished translating it into English. It can be downloaded from: http://linux2.arinet.org/index.php?option=com_remository&Itemid=31&func=sel… The filename is 'arinet-tr102-fasttrack-fc4v4E.pdf' Your suggestion and critics are very welcome. Thank you, -- Fajar Priyanto | Reg'd Linux User #327841 | Linux tutorial http://linux2.arinet.org 23:38:41 up 2:03, 2.6.11-1.1369_FC4 GNU/Linux Let's use OpenOffice. http://www.openoffice.org

2 2

CVS access for translation
by Andrew Martynov 11 Nov '05

11 Nov '05

Hello, FDSCo team! How can I get access to CVS to post translated release notes to Russian? I did following steps: - create Wiki account "AndrewMartynov" - made Self Introduction - sign CLA - create Fedora account "andrmart" - download via anonymous CVS release-notes files - prepare translated XML files Currently I could not get access to CVS via "CVS_ROOT=:ext:andrmart@....". I suppose my account was not activated yet. What should I do next? Regards, Andrew Martynov Inventa phone +7(095)7758777 fax +7(095)9270981 http://www.rhd.ru andrewm(a)inventa.ru

2 2

2024

2023

2022

2021

2020

2019

2018

2017

2016

2015

2014

2013

2012

2011

2010

2009

2008

2007

2006

2005

2004

2003

2002

docs November 2005