Discussion:
[Debian-Reference] Updating po translations of Debian Reference - correct work flow?
(too old to reply)
Beatrice Torracca
2017-09-21 17:10:04 UTC
Permalink
Hi all!

I have a doubt about the proper way to update the translations of the
Debian Reference.

I followed the instructions in the README.sources and used

"make wrap" and "make test" to test my translation (recently Osamu had
to fix a syntax mistake in my translation and I would prefer to avoid
giving work to others and check my translation myself)

It looks though like the "make test" action also updates the po
files. Every po file, but that is not a problem because I can commit
only the Italian one.

My doubt is that in this process I get lots of messages about unused
Entities. Messages like this one:

debian-reference.en.xml:17278: parser error : Entity 'freetype' not defined
<entry><ulink url="&freetype;">FreeType</ulink> 2.0 font rasteriza
^

and it looks to me like (almost) all messages related to entity
translations in the .po file become commented and unused.

I don't think this is what is supposed to happen.

I see there is also a "make entity" target. I am not sure that is
supposed to be used.

But mostly I am not sure what is the right .po file for me to
commit. The one before the make test action or the one I get
afterwards? I think that once the generation of the translation
documentation is carried out in the Debian server those entity
messages will turn out to be needed.

Right now I committed my last translation after the make wrap / make
test commands, but if I don't get any comment I will revert that
commit.

Thanks for any help or pointers,

beatrice
atzlinux
2017-09-22 01:40:02 UTC
Permalink
Hi:

    On my notebook, git pull the newest version,I use "make test
LANGPO=it" ,it can compile the it html success,no any errors display.

Can you try "make distclean",then "make test LANGPO=it" ?

BTW:
After the make wrap / make test commands,then commit *.po files,this action is no problem.

Faris Xiao
Post by Beatrice Torracca
Hi all!
I have a doubt about the proper way to update the translations of the
Debian Reference.
I followed the instructions in the README.sources and used
"make wrap" and "make test" to test my translation (recently Osamu had
to fix a syntax mistake in my translation and I would prefer to avoid
giving work to others and check my translation myself)
It looks though like the "make test" action also updates the po
files. Every po file, but that is not a problem because I can commit
only the Italian one.
My doubt is that in this process I get lots of messages about unused
debian-reference.en.xml:17278: parser error : Entity 'freetype' not defined
<entry><ulink url="&freetype;">FreeType</ulink> 2.0 font rasteriza
^
and it looks to me like (almost) all messages related to entity
translations in the .po file become commented and unused.
I don't think this is what is supposed to happen.
I see there is also a "make entity" target. I am not sure that is
supposed to be used.
But mostly I am not sure what is the right .po file for me to
commit. The one before the make test action or the one I get
afterwards? I think that once the generation of the translation
documentation is carried out in the Debian server those entity
messages will turn out to be needed.
Right now I committed my last translation after the make wrap / make
test commands, but if I don't get any comment I will revert that
commit.
Thanks for any help or pointers,
beatrice
--
翻译状态
<https://hosted.weblate.org/engage/debian-reference/zh_Hans/?utm_source=widget>
Beatrice Torracca
2017-09-22 06:10:01 UTC
Permalink
    On my notebook, git pull the newest version,I use "make test
LANGPO=it" ,it can compile the it html success,no any errors display.
Can you try "make distclean",then "make test LANGPO=it" ?
Hi!

thanks for the reply. I tried that.

Now I don't get all those errors but I have a different message:

====
sed -e 's/@-@amp@-@/\&/g' -e 's/@-@\([^@]\+\)@-@/\&\1;/g' > debian-reference.en.xml
******** You are missing ENTITY files *******
datadatepop.ent datadatesize.ent popcon.ent pkgsize.ent
*********************************************
run "make entity"
*********************************************
Makefile:171: set di istruzioni per l'obiettivo "datadatepop.ent" non riuscito
make: *** [datadatepop.ent] Errore 1

I will try the make entity command then ... I need to install some
packages for that so I have to wait. I will report the results :)

I found out another problem though.

The command "make dist clean" erased the temporary directory in my
home folder. ~/.tmp .

Not the content, the whole directory itself, which made other programs
start to complain or behaving badly since they were using the
temporary directory. I think the Makefile script could be corrected to
not delete the directory itself. Actually I think that even deleting
the whole content is bad enough, since some other program could have
stored some temporary valuable data there.

Maybe just not using $(TMPDIR) at all but just $(CURDIR)/tmp ?

Thanks for the help,

beatrice.
atzlinux
2017-09-22 09:50:01 UTC
Permalink
Post by Beatrice Torracca
Post by atzlinux
    On my notebook, git pull the newest version,I use "make test
LANGPO=it" ,it can compile the it html success,no any errors display.
Can you try "make distclean",then "make test LANGPO=it" ?
Hi!
thanks for the reply. I tried that.
====
******** You are missing ENTITY files *******
*********************************************
run "make entity"
*********************************************
Makefile:171: set di istruzioni per l'obiettivo "datadatepop.ent" non riuscito
make: *** [datadatepop.ent] Errore 1
I will try the make entity command then ... I need to install some
packages for that so I have to wait. I will report the results :)
You man run:
git checkout datadatepop.ent datadatesize.ent popcon.ent pkgsize.ent

These files is already in git.
Post by Beatrice Torracca
I found out another problem though.
The command "make dist clean" erased the temporary directory in my
home folder. ~/.tmp .
Not the content, the whole directory itself, which made other programs
start to complain or behaving badly since they were using the
temporary directory. I think the Makefile script could be corrected to
not delete the directory itself. Actually I think that even deleting
the whole content is bad enough, since some other program could have
stored some temporary valuable data there.
Maybe just not using $(TMPDIR) at all but just $(CURDIR)/tmp ?
I just look the Makefile,find the reason:

ifndef TMPDIR
TMPDIR  := $(CURDIR)/tmp
endif

# $ make clean     # clean files ready for tar
#######################################################################
.PHONY: clean
clean:
        -rm -f *.swp *~ *.tmp
        -rm -f $(DPO)/*~ $(DPO)/*.mo $(DPO)/*.po.*
        -rm -f $(DASC)/*~
        -rm -rf $(TMPDIR) $(CURDIR)/tmp

In my notebook OS,I don't definite the ENVIRONMENT variable TMPDIR before.
The command "env|grep TMPDIR" has no output.

so $(TMPDIR) and  $(CURDIR)/tmp is the same dir on my OS.
"make distclean" don't  erased the temporary directory in my home
folder. ~/.tmp .

I guess your OS had already definited the ENVIRONMENT variable TMPDIR
before,the value is ~/.tmp .

To deal with this question,My suggestion is modify Makefile:

diff --git a/Makefile b/Makefile
index 22d15e9..1067e0b 100644
--- a/Makefile
+++ b/Makefile
@@ -127,7 +127,7 @@ clean:
        -rm -f *.swp *~ *.tmp
        -rm -f $(DPO)/*~ $(DPO)/*.mo $(DPO)/*.po.*
        -rm -f $(DASC)/*~
-       -rm -rf $(TMPDIR) $(CURDIR)/tmp
+       -rm -rf $(CURDIR)/tmp
        -rm -f $(addsuffix .xml, $(addprefix $(MANUAL)., $(LANGALL)))
        -rm -f $(MANUAL).en.xml $(MANUAL).en.xmlt header.txt
        -rm -f $(RCACHE)

Would you report bug  to the package debian-reference ?

Thanks for your feedback!

Faris Xiao
Post by Beatrice Torracca
Thanks for the help,
beatrice.
--
翻译状态
<https://hosted.weblate.org/engage/debian-reference/zh_Hans/?utm_source=widget>
Holger Wansing
2017-09-22 06:50:01 UTC
Permalink
Hi,
Post by Beatrice Torracca
Hi all!
I have a doubt about the proper way to update the translations of the
Debian Reference.
I followed the instructions in the README.sources and used
"make wrap" and "make test" to test my translation (recently Osamu had
to fix a syntax mistake in my translation and I would prefer to avoid
giving work to others and check my translation myself)
It looks though like the "make test" action also updates the po
files. Every po file, but that is not a problem because I can commit
only the Italian one.
My doubt is that in this process I get lots of messages about unused
debian-reference.en.xml:17278: parser error : Entity 'freetype' not defined
<entry><ulink url="&freetype;">FreeType</ulink> 2.0 font rasteriza
^
I don't see such messages here when testing your translation. Italian builds
fine and without errors.
Also when looking at your latest commit
https://anonscm.debian.org/cgit/ddp/debian-reference.git/commit/?id=14c4a31705c521825c1250b2d0b41b0f770db7c8
everything looks fine. There are no messages deleted from the po files or
the like.

If you still see such messages on your PC, I suspect there might be some
software missing? The toolchain to build such documents is rather ambitious
sometimes...
'apt-get build-dep debian-reference' should install everything that's needed,
or look at https://packages.debian.org/source/stretch/debian-reference
Post by Beatrice Torracca
and it looks to me like (almost) all messages related to entity
translations in the .po file become commented and unused.
I don't think this is what is supposed to happen.
I see there is also a "make entity" target. I am not sure that is
supposed to be used.
But mostly I am not sure what is the right .po file for me to
commit. The one before the make test action or the one I get
afterwards? I think that once the generation of the translation
documentation is carried out in the Debian server those entity
messages will turn out to be needed.
Right now I committed my last translation after the make wrap / make
test commands, but if I don't get any comment I will revert that
commit.
No need for such reverting.


Holger
--
============================================================
Created with Sylpheed 3.5.1 under the n e w
D E B I A N L I N U X 9 " S T R E T C H " .

Registered Linux User #311290 - https://linuxcounter.net/
============================================================
Beatrice Torracca
2017-09-22 10:40:02 UTC
Permalink
Post by Holger Wansing
Post by Beatrice Torracca
My doubt is that in this process I get lots of messages about unused
debian-reference.en.xml:17278: parser error : Entity 'freetype' not defined
<entry><ulink url="&freetype;">FreeType</ulink> 2.0 font rasteriza
^
I don't see such messages here when testing your translation. Italian builds
fine and without errors.
Also when looking at your latest commit
https://anonscm.debian.org/cgit/ddp/debian-reference.git/commit/?id=14c4a31705c521825c1250b2d0b41b0f770db7c8
everything looks fine. There are no messages deleted from the po files or
the like.
If you still see such messages on your PC, I suspect there might be some
software missing? The toolchain to build such documents is rather ambitious
sometimes...
'apt-get build-dep debian-reference' should install everything that's needed,
or look at https://packages.debian.org/source/stretch/debian-reference
Hi,

thanks for your reply.

I did install dctrl-tools that I was missing; that seemed to have helped thanks.

Those messages were removed from the file I committed locally.
Post by Holger Wansing
Post by Beatrice Torracca
Right now I committed my last translation after the make wrap / make
test commands, but if I don't get any comment I will revert that
commit.
No need for such reverting.
Sorry, I should make more clear that I committed the file but I did
not push the commit in the Debian git repo. So I reverted it locally.

thanks for the help,

beatrice

Loading...