docs November 2003

docs@lists.fedoraproject.org

44 participants
41 discussions

Anaconda documents
by Taylor, ForrestX 14 Jan '04

14 Jan '04

Hi all, I am new to the list, although not new to Red Hat Linux. I am interested in writing docs for anaconda, so, is anyone was already working on them? Taking a look at the Documentation project site, I see that I need Docbook XML, stylesheets, Emacs PSGML (or NXML), etc. What is the learning curve for these? I have never done XML, and I am not an Emacs user (sorry to start a flamewar). Perhaps I could write the text and someone with more knowledge of XML/Emacs could put it into the right format. I am not unwilling to learn XML/Emacs, but my time might be spent better elsewhere. Let me know what you all think. Forrest

17 65

filename
by Tadashi Jokagi 08 Jan '04

08 Jan '04

Hi, It is a question about fedora-docs. Almost all the file names of fedora-docs do not correspond to multilingual. ex) documentation-guide/documentation-guide.xml developer-guide/developers-guide.xml Originally you should be as follows. ex) documentation-guide/documentation-guide-en.xml developer-guide/developers-guide-en.xml Is such correction made? ----.----1----.----2----.----3----.----4----.----5----.----6----.----7 Tadashi Jokagi/Shibuya city mailto:elf@elf.no-ip.org Yokukitana http://elf.no-ip.org/ Yokukitana with PukiWiki http://elf.no-ip.org/wiki/

5 20

nxml-mode for Emacs
by Tim Waugh 06 Dec '03

06 Dec '03

Emacs users might find this interesting: http://www.xmlhack.com/read.php?item=2061 Packages are here: ftp://people.redhat.com/twaugh/docbook/nxml-mode Tim. */

5 10

Fedora Docs FAQ - update 26 Nov 2003
by Karsten Wade 04 Dec '03

04 Dec '03

Please accept this humble FAQ. Please direct comments to the list, harsh criticism to me where I shall file it in its proper location. If we like this (which means no one says they don't like it?), then I'll propose either XML inclusion in the Doc Guide, or posting on the http://fedora.redhat.com/projects/docs/ page. FAQ originally proposed in http://www.redhat.com/archives/fedora-docs-list/2003-November/msg00029.html, now brought to you in living email color: ## begin FAQ Does Fedora Project need writers/editors? Yes! Writers are needed right now more then editors, until we have something to edit. What documents does FP need? FP documents are going to be of the tutorial/HOWTO variety. This is the most useful information we can gather at this time, and it works well with the distributed project. Currently, the only full-length guide is the Installation Guide. How is the docs project organized? Rather loosely right now. Tammy Fox (tfox(a)redhat.com) is the project leader. It has been proposed that translators can work in teams by languages. We may want to organize so that every writer has two-editors, and contributors can work in either or both roles. This makes for a more cumbersome process, but the quality control is higher. What is the process/procedure for translating documents? Details are currently outlined in this email: http://www.redhat.com/archives/fedora-docs-list/2003-November/msg00040.html What are PO files? PO files are textual, editable files used in translation. http://www.gnu.org/software/gettext/manual/html_mono/gettext.html#SEC7 What are some of the tutorial/HOWTOs currently proposed? From the mailing list: * Installing an SSH server with public/private key authentication * Configuring and using digital cameras * Anaconda documentation (in process) * Security considerings in installation * Security other (by topic, i.e. filesystems, host, etc.) * Configuring PDA Can I translate the legal notice? The legal notice page can be translated, but a statement that the translation is provided for convenience only and that the English language version takes precedence must be on the top of the page. What are the tools for writing documents? http://fedora.redhat.com/projects/docs details how to get the Documentation Guide source and tools. The toolchain is explained on that page, with the exception of PO files (see What are PO files?). Currently, there is a problem with PDF production (refer to https://bugzilla.redhat.com/bugzilla/show_bug.cgi?id=104983). If you have TeX experience and can help us resolve that one, please dive in! I have a tutorial in HTML, how do I convert it to DocBook? Grab html2db from http://www.cise.ufl.edu/~ppadala/tidy/ . What are some resources for learning DocBook? The definitive DocBook reference written and maintained by Norm Walsh is available at http://docbook.org/tdg/en/html/docbook.html . A combination tutorial and reference book is available at http://www.sagehill.net/docbookxsl/index.html . Dave Pawson maintains a DocBook FAQ at http://www.dpawson.co.uk/docbook/ . Can I have CVS write access? Eventually, we intend for full contributors to have write access to CVS, as well as access to other build environments. This is being worked out across the entire Fedora Project, and is due to be completed by the end of calendar year 2003. In the meantime, you can contact the docs project leader Tammy Fox (tfox(a)redhat.com) with your changes. If you wish to setup your own CVS repository, or join one that others are using while waiting for the main Fedora Project CVS to be set up, please see the mail thread starting at: http://www.redhat.com/archives/fedora-docs-list/2003-November/msg00140.html What else is can I do to help? Have ideas for admonition graphics? ## 30 ## -- Karsten Wade : Tech Writer, RHCE : o: +1.831.466.9664 kwade(a)redhat.com : http://rhea.redhat.com/ : c: +1.831.818.9995 Red Hat Applications : WAF, CMS, Portal Server -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- --

7 6

Brazilian Portuguese
by Hugo Cisneiros 03 Dec '03

03 Dec '03

Hi guys, Any brazilian guys here? We need to organize ourselves to begin working :) Please reply if you're interested in translating Fedora into pt_BR. []'s Hugo

5 10

New ENTITY declarations?
by Paul W. Frields 02 Dec '03

02 Dec '03

Do we need a block of additional ENTITY declarations as a standard in the templates, or are they up to the tutorial authors to use? I have been removing the existing block of Red Hat-specific declarations, and replacing them with more Fedora-specific ones, such as: <!ENTITY FEDORA "The Fedora Project"> <!ENTITY FEDORA-URL "<ulink url='http://fedora.redhat.com/'>http://fedora.redhat.com/</ulink>"> <!ENTITY DISTRO "Fedora Core"> <!ENTITY DOCS "The Fedora Documentation Project"> <!ENTITY DOCS-URL "<ulink url='http://fedora.redhat.com/projects/docs/'>http://fedora.redhat.com/projects/docs/</ulink>"> I don't see a need to standardize just for the sake of it; if this is something that authors are expected to do for themselves, that's ducky by me. I just don't want to step on any toes since I'm new to this part. :-) -- Paul W. Frields, RHCE

5 8

Japanese Translation
by Naoki Shigematsu 02 Dec '03

02 Dec '03

Hi, In Japan, Fedora JP Project started up and activity is begun. There are about 20 staff with an activity. First, we are beginning to translate the document. Web <fedora.redhat.com> Developer's Guide and Doucumentation guide. software po etc. Now, when Red Hat Linux was released, Japanese Documents were translated in Australia. This time, does the schedule exist? Thanks. -- Naoki Shigematsu

5 6

Red Hat vs. Fedora
by Hugo Cisneiros 01 Dec '03

01 Dec '03

Hi, I was revising the pt_BR.po file from the anaconda-po translation, and noticed that I still see many Red Hat Linux names instead of Fedora. We should leave it? For example... anaconda.pot - : ../partIntfHelpers.py:401 msgid "" "You have chosen to use a pre-existing partition for this installation " "without formatting it. Red Hat recommends that you format this partition to " "make sure files from a previous operating system installation do not cause " "problems with this installation of Linux. However, if this partition " "contains files that you need to keep, such as a users home directories, then " "you should continue without formatting this partition." msgstr "" - #: ../rescue.py:257 #, python-format msgid "" "The rescue environment will now attempt to find your Red Hat Linux " "installation and mount it under the directory %s. You can then make any " "changes required to your system. If you want to proceed with this step " "choose 'Continue'. You can also choose to mount your file systems read-only " "instead of read-write by choosing 'Read-Only'.\n" "\n" "If for some reason this process fails you can choose 'Skip' and this step " "will be skipped and you will go directly to a command shell.\n" "\n" msgstr "" - #: ../upgrade.py:475 msgid "" "This system appears to have third party packages installed that overlap with " "packages included in Red Hat Linux. Because these packages overlap, " "continuing the upgrade process may cause them to stop functioning properly " "or may cause other system instability. Please see the release notes for " "more information.\n" "\n" "Do you wish to continue the upgrade process?" msgstr "" - Call the developers? Change and commit the changes to CVS? Or just leave this alone? []'s Hugo

3 2

FDP on IRC
by Karsten Wade 29 Nov '03

29 Nov '03

Along with the plethora of other #fedora* channels on irc.freenode.net, a very few of us have been camping on #fedora-docs. Please feel free to come discuss anything on-topic, including and especially current list topics! - Karsten (quaid) -- Karsten Wade : Tech Writer, RHCE : o: +1.831.466.9664 kwade(a)redhat.com : http://rhea.redhat.com/ : c: +1.831.818.9995 Red Hat Applications : WAF, CMS, Portal Server -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- --

1 0

Status of french translation
by Philippe MALINGE 29 Nov '03

29 Nov '03

Hello all, I checked out the 'translate' package and it seems that all fr.po files are already translated in french. Is there any coordinator on this list? What's the job not been done yet? Thanks. -- Philippe MALINGE

2 1

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 2003