docs September 2006

docs@lists.fedoraproject.org

24 participants
40 discussions

Trans-quick-start-guide updates
by Manuel Ospina 21 Sep '06

21 Sep '06

Hi, I have update the translation quick start guide in order to address the following bugs: * Bug 204266: Improvement of 3. Translating Software * Bug 205167: Need to include info for New Language, which has no status page * Bug 198726: Improvement of the section Table of Contents I put a comment with the bug number before and after the edited texts in the XML file. I would appreciate if anyone could proofread and edit the changes. Thanks, Manuel Ospina

2 1

Final release notes deadline - 23 Sep Wiki freeze
by Karsten Wade 20 Sep '06

20 Sep '06

The release notes Wiki for FC6 are frozen on 23 Sep. 23:59 UTC for translation and inclusion in the ISO. This is your last chance to get content into the actual ISO. http://fedoraproject.org/wiki/Docs/Beats See below for a complete list of all beats that have no content for FC6[1]. These beats are going to be *dropped* from the final release notes, so no heading or content will appear. If you have anything that needs to be in the release notes, now is the time. After that, 07 Oct. is the next snapshot of the Wiki for the Web-only release of the notes. The Web-only release is not guaranteed to be translated. If you have filed any bugs or sent email to relnotes(a)fedoraproject.org, etc., that content is going to be included in the next few days. Any bugs must block 197471[2]. Best idea is to just edit the Wiki. :) Thanks again to all contributors; we set the bar high and once again made the hurdle to produce the best release notes in all Linux. - Karsten [1] Beats with no new content for FC6: http://fedoraproject.org/wiki/Docs/Beats/Printing http://fedoraproject.org/wiki/Docs/Beats/Samba http://fedoraproject.org/wiki/Docs/Beats/Security http://fedoraproject.org/wiki/Docs/Beats/DatabaseServers http://fedoraproject.org/wiki/Docs/Beats/ServerTools http://fedoraproject.org/wiki/Docs/Beats/Xorg http://fedoraproject.org/wiki/Docs/Beats/FileServers http://fedoraproject.org/wiki/Docs/Beats/PackageChanges http://fedoraproject.org/wiki/Docs/Beats/SystemDaemons http://fedoraproject.org/wiki/Docs/Beats/Legacy http://fedoraproject.org/wiki/Docs/Beats/ArchSpecific/x86 http://fedoraproject.org/wiki/Docs/Beats/Networking [2] https://bugzilla.redhat.com/bugzilla/showdependencytree.cgi?id=197471&hide_… -- Karsten Wade, RHCE, 108 Editor ^ Fedora Documentation Project Sr. Developer Relations Mgr. | fedoraproject.org/wiki/DocsProject quaid.108.redhat.com | gpg key: AD0E0C41 ////////////////////////////////// \\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\

1 0

Re: Testing the splash from XML
by Paul W. Frields 20 Sep '06

20 Sep '06

On Wed, 2006-09-20 at 19:37 +0100, Dimitris Glezos wrote: > O/H Paul W. Frields έγραψε: > > Hi Dimitris, > > > > Thanks for your work on the splash page... people are very excited about > > it. Tommy wrote some neat script-fu to redirect a browser to the right > > language; it should be easy for me to include this in the packaging as > > well. > > > > What we also would like is the ability for our normal translation > > process to work on the splash page as well, which means it would be > > least disruptive both to us and the translators for it to be built from > > DocBook XML source like our other docs. A different CSS is easy to > > apply in the packaging process. So what I'd like you to do is to try to > > build this using our toolchain, and simply copy in your CSS to see how > > it works. > > Hi Paul, > > first of all, kudos for the good work. I tried the doc and it built just fine. > Some observations: > > 1. It seems the text in your version is a bit old. I'll try to merge them. > (that's why I wanted to go into DocBook as soon as possible). > > 2. We'll need to add some ID and CLASS attributes. Is that OK? Actually, that's part of the problem that I was hoping you would see. There's no easy way to add those attributes from inside DocBook XML and have them stick (I've tried). But I had a thought today that some XSLT might be able to make it stick properly, especially if I build this particular page as XHTML. > 3. We should pass the HTML through `tidy` before publishing it. Something > like: `tidy -utf8 -i -asxhtml index.html > index.tidy.html`. -1. We're simply packaging this onto user systems where most users are not going to care about it other than to read the content in a browser. How it looks is not relevant, and it could conceivably put a requirement in place (i.e. tidy) that we are not prepared to carry over into another build system. KISS principle says let it ride, plus see below... > 4. I'll provide a different CSS, that complements fedora.css. Well, a few changes wouldn't be bad, keeping in mind that the banner work you added and showed on the art list were *really* nice, and we'd like to keep that, pursuant to whatever is dictated for trademark protection. If you find a complementary color scheme, I think that's great. > So, what I am going to do is try to fix the XHTML (as little intervention as > possible) to put the CSS into work. I'll first run the tidy thing and give you > the differences from that, so that you can put them inside the XSLT. OK? Actually, we don't want to fix the XHTML in place. What we want is to be able to *automate* this procedure as part of the build process regardless of content, and I think a diff-type patch is not a good way of doing that. Better would be an XSLT stylesheet to simply separate out the two columns with a @CLASS attribute, for example. If you can write that, let me know. If you can't I will find some time to do it. cc'ing Docs to let everyone know this is progressing. -- Paul W. Frields, RHCE http://paul.frields.org/ gpg fingerprint: 3DA6 A0AC 6D58 FEC4 0233 5906 ACDB C937 BD11 3717 Fedora Project Board: http://fedoraproject.org/wiki/Board Fedora Docs Project: http://fedoraproject.org/wiki/DocsProject

1 0

Release Notes freeze for FC6
by Paul W. Frields 20 Sep '06

20 Sep '06

Release notes will be frozen on the wiki for translation this Saturday, 23 September 2006. Any content not updated there will not be translated, and will not be in the FC6 final ISO spin. Please make your updates by Friday 22 September 2006 at 2359 UTC to ensure they are available to FC6 users. http://fedoraproject.org/wiki/DocsProject/Schedule Content will be unfrozen following the XML conversion and release to the Translation Project. At that time, you may again make changes to the wiki, but these changes will *NOT* be in the ISO or FC6 final release. They will be published on the Web as an errata release. This Web page is linked prominently from the top of the Release Notes included in the FC6 ISO spin. -- Paul W. Frields, RHCE http://paul.frields.org/ gpg fingerprint: 3DA6 A0AC 6D58 FEC4 0233 5906 ACDB C937 BD11 3717 Fedora Project Board: http://fedoraproject.org/wiki/Board Fedora Docs Project: http://fedoraproject.org/wiki/DocsProject

1 0

Re: [fedora-java] FOP, gcj, classpath, oh my!
by Thomas Fitzsimmons 20 Sep '06

20 Sep '06

Hi Karsten! Karsten Wade wrote: > Can someone give fedora-docs-list an update about our ability to put out > a 100% free, gcj-compiled DocBook toolchain? I've been meaning to test this against Rawhide but haven't got to it yet. When I do, I'll report the status here. (I have a feeling there will have been improvements because of the Java2D work in GNU Classpath). Tom

4 5

new Firefox/splash page for FC6?
by Karsten Wade 18 Sep '06

18 Sep '06

If we move quickly, we can implement a new default Firefox homepage for FC6. Let's make it a surprise! We can only really improve on what we have, so our risk is low. Dimitris -- are you available and interested in leading this? If not, any ideas who might want to do this? I understand we want this: * Simple splash page * Prominent links to useful content - Release notes - Deep link to Overview - Links all languages - Off-site Fedora FAQ - fedoraproject.org/wiki/FAQ - *Optional* - include locally, riskier - May need Makefile integration, increases risk - Other useful links * ??? If you can do the HTML and the CSS, do or get some help with the graphics, I'm confident we can get this in for FC6. How refreshing to the eye it would be! - Karsten -- Karsten Wade, RHCE, 108 Editor ^ Fedora Documentation Project Sr. Developer Relations Mgr. | fedoraproject.org/wiki/DocsProject quaid.108.redhat.com | gpg key: AD0E0C41 ////////////////////////////////// \\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\

5 19

PDF conversion, stylesheets, new wiki page
by Dimitris Glezos 16 Sep '06

16 Sep '06

Hi all. I read various things about the PDF conversion and installed the tools to try to hack into the problems we have. I'll see what I can do with stylesheets. I put most of the things that helped me out on the following wiki page: http://fedoraproject.org/wiki/DocsProject/Tools/PDFconversion Someone with more experience than mine (that is, one night's experience), should probably correct or put more things up there. Concerning stylesheets, if anyone has any references that might be helpful, for example any FOSS project that did produce nice-looking PDFs, I'm all ears. I know from past experience, that the PHP project rendered nice PDFs and CHMs for their manual (although they stopped producing PDF versions some years now...) -dim -- Dimitris Glezos Jabber ID: glezos(a)jabber.org, PGP: 0xA5A04C3B http://dimitris.glezos.com/ "He who gives up functionality for ease of use loses both and deserves neither." (Anonymous) --

2 1

[Fwd: [Fedora Project Wiki] Update of "Docs/Beats/Extras" by DavidWoodhouse]
by Paul W. Frields 15 Sep '06

15 Sep '06

Not sure how we want to treat this... The Release Notes are explicitly about Fedora Core, and not Extras. This seems like a somewhat useful note about Exim -- which is not in Core -- but I don't think the Release Notes are the right place for it. I would rather see this kept on the wiki under the Extras/ namespace, say in Extras/News/* or Extras/Notes/*, and simply reference that collection from Docs/Beats/Extras. What thoughts do other list members have? -- Paul W. Frields, RHCE http://paul.frields.org/ gpg fingerprint: 3DA6 A0AC 6D58 FEC4 0233 5906 ACDB C937 BD11 3717 Fedora Project Board: http://fedoraproject.org/wiki/Board Fedora Docs Project: http://fedoraproject.org/wiki/DocsProject

4 6

Re: [fedora-java] FOP, gcj, classpath, oh my!
by Karsten Wade 15 Sep '06

15 Sep '06

On Thu, 2006-09-14 at 19:21 +1000, Cameron McCormack wrote: > Hi people. Hi Cameron: I'm going to leave your reply intact below, just dropping a note that I sent a separate message to fedora-docs-list summarizing the thread so far and calling attention to what we can do to help. Of the tools-herders, some are busy with test3 packaging, but we certainly must have some people with documents they want to test (into PDFs). I'll keep both lists informed, for now. Thanks, Karsten > Karsten Wade: > > > > Can someone give fedora-docs-list an update about our ability to put out > > > > a 100% free, gcj-compiled DocBook toolchain? > > Thomas Fitzsimmons: > > > I've been meaning to test this against Rawhide but haven't got to it yet. When > > > I do, I'll report the status here. (I have a feeling there will have been > > > improvements because of the Java2D work in GNU Classpath). > > Mark Wielaard: > > Yes, I have CCed Cameron and Francis who might have the most up to date > > status on all this. If we have a good description of what really must > > work then we can concentrate on those parts of gcj, classpath, batik and > > fop that are essential to the documentation team. > > > > I installed FC6test3, but cannot find the fop package that Tom created > > (or did I only dream that he did? maybe it was never submitted?). We > > might need to import/backport some recent classpath CVS fixes into the > > FC6 libgcj to make it all work since I know just days ago some new > > support for batik went into GNU Classpath (hi Francis, hi Cameron). > > Yes, I’ve just last week started to try to identify what Classpath > problems are preventing Batik from working. Since the Fedora people will > (presumably) only be interested in rasterising static SVG documents, > this should avoid having to deal with any Swing issues just yet. > > We are collecting the issues regarding FOP and Batik here: > > http://wiki.apache.org/xmlgraphics/GnuClasspathCompatibility > > One thing I have noticed during my limited testing so far is that the > rasteriser (and the SVG browser, too) is running pretty slowly compared > to on Sun’s JVM. My first guess would be a mismatch of ColorModels > between what Batik is providing and what the Cairo layer underneath is > exepcting (which was a problem for Batik running under Sun’s OSX JVM a > while ago), but I haven’t checked into this yet. > > Some simple files work, others don’t. I really have to do some more > testing before knowing which areas need to be looked at. I will report > back (and update the wiki page above) when I have found out more. > > If the Fedora documentation people want to provide examples of the kinds > of things they will be processing, that would help to prioritise the > work. > > I am not sure about the state of FOP running with Classpath. Jeremias > Märki (CC’d) should know more. > > Thanks, > > Cameron > -- Karsten Wade, RHCE, 108 Editor ^ Fedora Documentation Project Sr. Developer Relations Mgr. | fedoraproject.org/wiki/DocsProject quaid.108.redhat.com | gpg key: AD0E0C41 ////////////////////////////////// \\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\

1 0

Re: [fedora-java] FOP, gcj, classpath, oh my!
by Thomas Fitzsimmons 14 Sep '06

14 Sep '06

Mark Wielaard wrote: > On Thu, 2006-09-07 at 10:37 -0400, Thomas Fitzsimmons wrote: >> Hi Karsten! >> >> Karsten Wade wrote: >>> Can someone give fedora-docs-list an update about our ability to put out >>> a 100% free, gcj-compiled DocBook toolchain? >> I've been meaning to test this against Rawhide but haven't got to it yet. When >> I do, I'll report the status here. (I have a feeling there will have been >> improvements because of the Java2D work in GNU Classpath). > > Yes, I have CCed Cameron and Francis who might have the most up to date > status on all this. If we have a good description of what really must > work then we can concentrate on those parts of gcj, classpath, batik and > fop that are essential to the documentation team. > > I installed FC6test3, but cannot find the fop package that Tom created > (or did I only dream that he did? maybe it was never submitted?). Yes, I never submitted my packages as they were major hacks. Building Batik from the JPackage RPMs is not really feasible, because of the web of dependencies (rhino brings in many), the worst one being maven. None of these dependencies are packaged in FC or FE. On the FOP front, the FOP developers have done work in CVS to eliminate com.sun dependencies, work that hasn't been released and packaged yet. I'd recommend building Batik and FOP from CVS if you're trying these out since then you can configure out the rhino dependency, and so you're working with the updated FOP. Tom

1 0

2024

2023

2022

2021

2020

2019

2018

2017

2016

2015

2014

2013

2012

2011

2010

2009

2008

2007

2006

2005

2004

2003

2002

docs September 2006