Minutes of FDSCo Meeting Dec 13 2005
by Stuart Ellis
Attending:
---------
Karsten Wade (quaid)
Tommy Reynolds (megacoder)
Gavin Henry (G2)
Tammy Fox (tcf_home)
Stuart Ellis (elliss)
Regrets:
--------
Paul Frields (stickster)
Schedule of Tasks:
------------------
http://www.fedoraproject.org/wiki/DocsProject/FedoraDocsSchedule
Highlights:
-----------
* Karsten: Discussion of possible DocsRawHide enhancements. Useful
developments might include: e-mail build errors to document maintainers,
building of branches other than the current branch, listing of documents
on Fedora Project website(s).
* Tommy: Currently working on the handling of images in the document
build process.
* Tommy: Documentation Guide to be updated to match current build
processes.
* Karsten: There are still open slots for Release Note beats. An e-mail
will be sent out to request a writer for the Legacy beat, and for
writers to cover a new Extras beat.
Other open slots: Kernel, File Systems, Development Tools, Samba, System
Daemons, x86-specific content, x86_64-specific content, Database
Servers, and Backwards Compatibility.
Full IRC Log:
-------------
https://www.redhat.com/archives/fedora-dsco-list/2005-December/msg00004.html
--
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
18 years, 4 months
[RFC] Image filename conventions
by Tommy Reynolds
Hello, ya'll!
Some folk have their document images in a "figs/" subdirectory tree
under the document directory. Large documents may have additional
"figs/part1" style subdirectories, too.
The lack of a formal filenaming scheme makes selectively copying
files awkward. Below is our current convention:
<filename>-<locale>.<ext>
such as "watermark-ru.png". Simple, eh?
The problem is that some filenames use the "-" minus sign to separate
words in the filename:
this-is-my-picture.png
Is "picture" part of the filename or the language designation? It is
difficult for a shell script to decode this just by looking at the
filename.
I propose a file naming scheme to simplify the selective copying of
files. This will help reduce the complexity of the RPM packaging
tools.
Only three formal rules are needed:
1) The minus sign "-" may not be used as part of the filename
component.
1) The minus sign only introduces the locale for the file.
1) Filenames without a locale component are considered language
neutral.
With these conventions in place:
"foo.png" is a language-neutral graphic.
"foo-it.png" is a graphic with Italian text.
"foo-bar.png" is not permitted usage.
Comments? Alternatives? Bribes?
Cheers
18 years, 4 months
Documentation Guide Chapter 9
by Tommy Reynolds
The current Documentation Guide Chapter 9 "Converting to HTML and
PDF" is insufficient. Does any one mind if I update it?
Cheers
18 years, 4 months
Re: docs-common/images Makefile, 1.5, 1.6 watermark-de.png, 1.1, 1.2 watermark-en.png, 1.1, 1.2 watermark-it.png, 1.1, 1.2 watermark-ja_JP.png, 1.1, 1.2 watermark-ru.png, 1.1, 1.2 watermark-zh_CN.png, 1.1, 1.2 watermark-zh_CN.svg, 1.1, 1.2
by Yuan Yijun
2005/12/10, jtr Tommy Reynolds <fedora-docs-commits(a)redhat.com>:
> - <text font-family="AR PL ZenKai Uni" font-stretch="wider" text-anchor="middle" x="0" y="0">文 档 草 案</text>
> + <text font-family="'AR PL ZenKai Uni'" font-stretch="wider" text-anchor="middle" x="0" y="0">文 档 草 案</text>
could you please explain it?
--
bbbush ^_^
18 years, 4 months
zh_CN watermark added
by Tommy Reynolds
bbbush,
Thank you for submitting the watermark-zh_CN.* files.
I'm having trouble recreating the .PNG, though.
Forgive my ignorance on this matter. Where can I find the font "AR
PL ZenKai Uni"? Is that a standard Fedora font? If so, from what
package?
Thanks!
18 years, 4 months
Re: [ANN] Draft Document Rendering
by Tommy Reynolds
Uttered Francesco Tombolini <tombo(a)adamantio.net>, spake thus:
> Hallo Tommy, the translation for "DRAFT / NOT FOR
> REFERENCE" notation in italian language is "BOZZA / NON PER RIFERIMENTO"
Thank you, Francesco. I've added it to CVS.
Ciao
18 years, 4 months
[ANN] Draft Document Rendering
by Tommy Reynolds
Hi, Folks!
Unless you are involved, or interested in, the Fedora Doc publishing
infrastructure you can skip this but you're welcome to stay. We
are keeping the default behaviour of watermarking the HTML documents
produced from the CVS files as "DRAFT / NOT FOR REFERENCE".
Per the discussion and suggestions on this list, I've made using
different CSS stylesheets much easier. This should allow a batch
building process to choose, at rendering time, which CSS stylesheet
to use.
Two new "docs-common/Makefile.common" macros have been added:
${HTMLCSS} should contain the path to whatever CSS stylesheet should
be used.
${HTMLCSSEXTRA} should list any additional files needed by the CSS
stylesheet, such as the "images/watermark.png" file used by the
default stylesheet.
Currently there are several ways of specifying any of the
"docs-common/Makefile.common" macros:
1) Do nothing and accept the default values coded in
"docs-common/Makefile.common".
2) Add the definitions at the top of the document "Makefile". This
is NOT recommended.
3) Create the file "Make.paths" in the document directory and place
the macro definitions in there, just as if they were part of
"docs-common/Makefile.common".
4) Export the macro definitions into your environment before doing
the make.
5) Define the macro on the make command line:
$ make HTMLCSS=/path/to/my.css html
For now, I recommend either method #3 or #5, depending on how many
times you need to build the document.
As always, suggestions, comments and bribes are cheerfully accepted.
Cheers
18 years, 4 months
