Packaging Tutorial

Hi,

On Sat, May 07, 2011 at 11:06:20AM +0200, Lucas Nussbaum wrote:

Hi,

I've been working on a packaging tutorial (see [1]).

[1] http://www.lucas-nussbaum.net/blog/?pg6

I'm looking for suggestions from debian-doc@ to maximize exposure of the
tutorial. Currently, the tutorial is not linked from anywhere, and not
packaged, but I'm not sure of what would be the best way(s) to advertise
it to prospective readers.

I saw it few days ago and looks nice.

It does not have as much bias toward dh7 (New NM guide is very biased
and this was my delivarate choice.)

By the way, I just rebumped NM guide just recently.
http://www.debian.org/doc/manuals/m...ex.en.html

For sarge updates, many people was asking non-technical intoduction. I
decided not to do so and waited for the recent update. I basically gave
pointers only to such thing in "1.1. Social dynamics of Debian".
There, I included: Debian: "17 years of Free Software, "do-ocracy", and
democracy" by Stefano Zacchiroli which does very good slide
presentation.

I am thinking to add this LaTeX based slides as one of the project web
page, if possible. Then we do not need to use much of the non-debian
server capacity. Javi used to put some slides on DDP but that was not
so publicised (maybe because they were spanish??? I do not recall much).
The only thing we need to agree is which directory tree o use and which
cron script manages this build.(And who?) DDP is very quiet these days.

Of course, I am thinking to give pointer from NM guide. I think in
"1.3. Documentation needed for development", adding one paragraph with
itemized list (currently only your 4 slides.) may be a good start
if you do not mind.

Something along:
| The following is the alternative tutorial documentation which you may
| read along with this document:
| * Debian Packaging Tutorial

Regards,

Osamu

PS: I was keeping myself busy to convert as much old SGML docs to XML
using new conversion path whi ig becoming quite useful.



To UNSUBSCRIBE, email to
with a subject of "unsubscribe". Trouble? Contact
Archive: http://lists.debian.org/

On Sat, May 07, 2011 at 11:54:07PM +0900, Osamu Aoki wrote:
...

Of course, I am thinking to give pointer from NM guide. I think in
"1.3. Documentation needed for development", adding one paragraph with
itemized list (currently only your 4 slides.) may be a good start
if you do not mind.

Since I can not think why not, I added links in NM guide.
(If you do not like it, let me know how it can be improved.)
It will be published in 4 hours at:
http://www.debian.org/doc/manuals/m...l#needdocs

Osamu


To UNSUBSCRIBE, email to
with a subject of "unsubscribe". Trouble? Contact
Archive: http://lists.debian.org/

Hash: SHA256

Hi,

Le 07/05/2011 12:13, Osamu Aoki a écrit :

Since I can not think why not, I added links in NM guide.
(If you do not like it, let me know how it can be improved.)
It will be published in 4 hours at:

Please, avoid linking to English only content if not necessary (at
worst, if a translation is outdated, the English content will be
provided anyway, and I believe that two translations will be up to date
after the next website rebuild anyway ;-):

http://www.debian.org/doc/manuals/m...t#needdocs

Please also note that the links seem broken from the PDF file (the “;”
are changed to “%3b”).

Regards

David



To UNSUBSCRIBE, email to
with a subject of "unsubscribe". Trouble? Contact
Archive: http://lists.debian.org/

Hi,

On Sat, May 07, 2011 at 01:33:54PM -0400, David Prévot wrote:

Hash: SHA256

Hi,

Le 07/05/2011 12:13, Osamu Aoki a écrit :

> Since I can not think why not, I added links in NM guide.
> (If you do not like it, let me know how it can be improved.)
> It will be published in 4 hours at:

Please, avoid linking to English only content if not necessary (at
worst, if a translation is outdated, the English content will be
provided anyway, and I believe that two translations will be up to date
after the next website rebuild anyway ;-):

http://www.debian.org/doc/manuals/m...t#needdocs

Thanks.

Since this is in LateX and po4a can support LaTeX source, once we move
this to DDP, it may be trivial to add French version :-)
(man 3 Locale::Po4a::LaTeX)

Does language auto-selection scheme works for PDF too?
foo.en.pdf
foo.fr.pdf

(As for CDBS link, I think we leave it as English only considering its
limitted purpose.)

Please also note that the links seem broken from the PDF file (the “;”
are changed to “%3b”).

I think this is bug in dblatex conversion script to substitute ";" into
"%3B" using Percent-encoding
(http://en.wikipedia.org/wiki/Percent-encoding). I think links from the HTML
web page works fine.

By the way, I found the reason of the blue link for developers-reference
PDF. It seems to be caused by pdflatex. PDF build from DocBook XML
seems to be a mine field og bugs when it comes to URL. It seems to be
caused by mangling methods used to feed pdflatex.

Osamu


To UNSUBSCRIBE, email to
with a subject of "unsubscribe". Trouble? Contact
Archive: http://lists.debian.org/

On 10/05/11 at 10:24 -0400, David Prévot wrote:

Le 07/05/2011 21:16, Osamu Aoki a écrit :

> Since this is in LateX and po4a can support LaTeX source, once we move
> this to DDP, it may be trivial to add French version :-)
> (man 3 Locale::Po4a::LaTeX)

Jean-Philippe just proposed to translate it into French, and I gave a
first shot to Locale::Po4a::LaTeX, result of the following command attached:

po4a-gettextize -o definitions=perso -f latex \
-m packaging-tutorial.tex -p packaging-tutorial.pot

Where perso contains:

% po4a: command author []{}
% po4a: command -date {_}
% po4a: command frame {}
% po4a: environment axis []
% po4a: environment frame []{_}
% po4a: verbatim environment lstlisting
% po4a: environment tikzpicture []

I'd welcome some comment and help to provide a more friendly POT file:

I'm wondering whether it wouldn't be better to translate on a per-slide
basis, rather than on a per-string basis.
Since the goal is to great a visual document, it is likely that some
fine-tuning and restructuring will be needed within some slides (to
avoid line wrapper, for example)

- kick away the “ \\hbr” and “ \\br” stuff;

no, that's useful to make the presentation look nicer.

- kick away the \mode<presentation>, \usetheme{debian} and alike;

yes, could be moved to a separate file

- offer directly the content of pdftitle (instead of pdftitle={Debian
Packaging Tutorial},bookmarks…

I'm not sure of what you mean (I must admit I don't know po4a, despite
having its original dev in the office next to me).

Modifying the packaging-tutorial.tex source (to make it po4a-friendly)
is an option if needed.

Sure

I've added the po4a devel list in order to gather more idea, source is
available at:

git://git.debian.org/~lucas/packaging-tutorial.git

BTW, if we are to provide a way to easily translate this Tutorial, maybe
could we host it inside the DDP (provided that Lucas agrees to move the
development to the Subversion repository).

Yes, I agree to host it within DDP. Is switching to svn really a
requirement in the process? If we can host it on the DDP git repo, I
would prefer that. If we can't, never mind, and let's use svn.

- Lucas


To UNSUBSCRIBE, email to
with a subject of "unsubscribe". Trouble? Contact
Archive: http://lists.debian.org/