Trans-quick-start-guide updates
by Manuel Ospina
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
17 years, 6 months
Re: Testing the splash from XML
by Paul W. Frields
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
17 years, 6 months
Release Notes freeze for FC6
by Paul W. Frields
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
17 years, 6 months
Re: [fedora-java] FOP, gcj, classpath, oh my!
by Thomas Fitzsimmons
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
17 years, 6 months
new Firefox/splash page for FC6?
by Karsten Wade
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
////////////////////////////////// \\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\
17 years, 6 months
PDF conversion, stylesheets, new wiki page
by Dimitris Glezos
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)
--
17 years, 6 months
Re: [fedora-java] FOP, gcj, classpath, oh my!
by Karsten Wade
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
////////////////////////////////// \\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\
17 years, 6 months
Re: [fedora-java] FOP, gcj, classpath, oh my!
by Thomas Fitzsimmons
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
17 years, 6 months