[Date Prev][Date Next] [Thread Prev][Thread Next] [Date Index] [Thread Index]

[RFR] templates://pluxml/{templates}



Please find, for review, the debconf templates and packages descriptions for the pluxml source package.

This review will last from Saturday, September 14, 2013 to Tuesday, September 24, 2013.

Please send reviews as unified diffs (diff -u) against the original
files. Comments about your proposed changes will be appreciated.

Your review should be sent as an answer to this mail.

When appropriate, I will send intermediate requests for review, with
"[RFRn]" (n>=2) as a subject tag.

When we will reach a consensus, I send a "Last Chance For
Comments" mail with "[LCFC]" as a subject tag.

Finally, a summary will be sent to the review bug report,
and a mail will be sent to this list with "[BTS]" as a subject tag.

Rationale:
--- pluxml.old/debian/templates	2013-09-04 07:20:40.799525585 +0200
+++ pluxml/debian/templates	2013-09-14 13:39:34.375384769 +0200
@@ -6,10 +6,10 @@
  PluXml can run on any web server supporting PHP, but only listed web servers
  can be configured automatically by this package.
  .
- Please note that you will have to make sure a PHP interpreter is enabled for
- your webserver.
- .
  Please select the web servers that should be configured for PluXml.
+ .
+ Please note that you will have to make sure a PHP interpreter is enabled for
+ the webserver.

I think it is more logical to revert these paragraphs.

 
 Template: pluxml/system/reload-webserver
 Type: boolean
@@ -25,9 +25,9 @@
 Type: boolean
 Default: false
 _Description: Purge blog data on package removal?
- PluXml will store all your blog data in /var/lib/pluxml.
+ PluXml will store all blog data in /var/lib/pluxml.
  .
- Accepting this option will remove all the blog data when this package is
+ Accepting this option will remove all blog data when this package is
  purged, which will leave you with a tidy system but may cause data loss if you
  purge an operational blog.

Unpersonnalize: this is not necessarily *my* blog

drop a French "the"..:-)

 
@@ -45,16 +45,14 @@
 
 Template: pluxml/blog/lang
 Type: select
-__Choices: German (de), English (en), Spanish (es), French (fr), Italian (it), Dutch (nl), Polish (pl), Portuguese (pt), Romanian (ro), Russian (ru)
+__Choices: German, English, Spanish, French, Italian, Dutch, Polish, Portuguese, Romanian, Russian
 Choices-C: de, en, es, fr, it, nl, pl, pt, ro, ru
-# You must NOT translate this string, but you can change its value. The comment
-# between brackets is used to distinguish this msgid from the one in the
-# Choices list; you do not have to worry about them, but you simply have to
-# choose a msgstr among the language codes listed in the parentheses of the
-# English Choices above, e.g. msgstr "nl" (NOT msgstr "Dutch (nl)").
-_Default: en[ default language]
+# You must NOT translate this string, but you can change its value.
+# You should put your language (if it is among the possible choices)
+# so that it becomes the default for users of that language
+_Default: English

The default should match "Choices", not Choices-C

As a consequence, I think it's not worth keeping the ISO code
mentioned in each choice

 _Description: Blog default language:
- Please choose the default language of your blog, which will be used for the
+ Please choose the default language of this blog, which will be used for the
  public pages.
  .
  Registered blog contributors will be able to choose their language for the

Unpersonnalize again

@@ -64,7 +62,7 @@
 Type: string
 Default: PluXml
 _Description: Blog title:
- Please choose a title for your blog, which will be displayed in the top of each
+ Please choose a title for this blog. It will be displayed on top of each
  page and in the browser window title.

Ditto. Also split in sentences as "which" in the original string
mostly relates to "your blog" than "title".
 
 Template: pluxml/blog/description
@@ -75,7 +73,7 @@
 # (replace $LANG by your language code), under the name "L_SITE_DESCRIPTION".
 _Default: Blog or CMS, XML powered!
 _Description: Blog description or subtitle:
- Please choose a short description for your blog, which will be displayed as a
+ Please choose a short description for this blog. It will be displayed as a
  subtitle in the top of each page and in the browser window title.


Same rationale
 
 Template: pluxml/blog/name
@@ -92,8 +90,8 @@
 Default: admin
 _Description: Administrator user name:
  Please enter a name for the administrator account, which will be used to manage
- PluXml's configuration, users and content. The username should be composed of
- lowercase ASCII letters only.
+ PluXml's configuration, users and content. The user name should only
+ contain lowercase ASCII letters.
 
Make the second sentence clearer?

s/username/user name

 Template: pluxml/blog/password
 Type: password
@@ -103,10 +101,11 @@
 Template: pluxml/blog/confirm
 Type: password
 _Description: Confirm password:
- Please enter the same administrator password again to verify you have typed it
- correctly.
+ Please enter the same password again to verify that you have
+ typed it correctly.

Use the "standard" formula from Debian Installler

 
 Template: pluxml/blog/failpass
 Type: error
-_Description: Password mismatch
- The two passwords you entered are not identical. Please try again.
+_Description: Password input error
+ The two passwords you entered were not the same. Please try again.
+ 

Same template than D-I, here again

--- pluxml.old/debian/control	2013-09-04 07:20:40.799525585 +0200
+++ pluxml/debian/control	2013-09-14 13:39:56.960010019 +0200
@@ -13,7 +13,7 @@
 Depends: ${shlibs:Depends}, ${misc:Depends}, ucf, php5
 Recommends: php5-gd
 Suggests: mail-transport-agent
-Description: Light blog engine using XML files
+Description: light blog engine using XML files
  PluXml is a light and simple blog and CMS engine that uses simple XML files
  to store its data and requires no database. It has all the usual features
  (static pages, comments, categories, tags, medias, RSS feed...) and supports

drop leading uppercase (see Developers Reference for such rationale)

-- 


Template: pluxml/system/webservers
Type: multiselect
__Choices: apache2, lighttpd
Default: apache2
_Description: Web servers to configure:
 PluXml can run on any web server supporting PHP, but only listed web servers
 can be configured automatically by this package.
 .
 Please select the web servers that should be configured for PluXml.
 .
 Please note that you will have to make sure a PHP interpreter is enabled for
 the webserver.

Template: pluxml/system/reload-webserver
Type: boolean
Default: true
_Description: Should the web server(s) be reloaded?
 To activate the configuration for PluXml, the web server(s) have to be
 reloaded.
 .
 Accepting this option will reload the web server(s) when the installation is
 complete, otherwise you will have to do that yourself.

Template: pluxml/system/purgedata
Type: boolean
Default: false
_Description: Purge blog data on package removal?
 PluXml will store all blog data in /var/lib/pluxml.
 .
 Accepting this option will remove all blog data when this package is
 purged, which will leave you with a tidy system but may cause data loss if you
 purge an operational blog.

Template: pluxml/system/writeconf
Type: boolean
Default: false
_Description: Allow editing the configuration files from the web interface?
 PluXml includes a web-based configuration interface that allows the user to
 change blog settings, including the list of registered users. To be usable, it
 requires the web server to have write permission to the configuration files.
 .
 Accepting this option will give the web server write permissions to the
 configuration files. These files will still be readable and editable by hand
 regardless of whether or not you accept this option.

Template: pluxml/blog/lang
Type: select
__Choices: German, English, Spanish, French, Italian, Dutch, Polish, Portuguese, Romanian, Russian
Choices-C: de, en, es, fr, it, nl, pl, pt, ro, ru
# You must NOT translate this string, but you can change its value.
# You should put your language (if it is among the possible choices)
# so that it becomes the default for users of that language
_Default: English
_Description: Blog default language:
 Please choose the default language of this blog, which will be used for the
 public pages.
 .
 Registered blog contributors will be able to choose their language for the
 administration pages.

Template: pluxml/blog/title
Type: string
Default: PluXml
_Description: Blog title:
 Please choose a title for this blog. It will be displayed on top of each
 page and in the browser window title.

Template: pluxml/blog/description
Type: string
# This is the default blog description (subtitle); official translations of
# this string are available at
# <https://github.com/pluxml/PluXml/tree/master/core/lang/$LANG/install.php>
# (replace $LANG by your language code), under the name "L_SITE_DESCRIPTION".
_Default: Blog or CMS, XML powered!
_Description: Blog description or subtitle:
 Please choose a short description for this blog. It will be displayed as a
 subtitle in the top of each page and in the browser window title.

Template: pluxml/blog/name
Type: string
Default: PluXml Administrator
_Description: Administrator real name:
 Please enter the real name associated with the blog administrator account.
 .
 This name will be displayed for articles written with the administrator
 account.

Template: pluxml/blog/login
Type: string
Default: admin
_Description: Administrator user name:
 Please enter a name for the administrator account, which will be used to manage
 PluXml's configuration, users and content. The user name should only
 contain lowercase ASCII letters.

Template: pluxml/blog/password
Type: password
_Description: Administrator password:
 Please choose a password for the blog administrator account.

Template: pluxml/blog/confirm
Type: password
_Description: Confirm password:
 Please enter the same password again to verify that you have
 typed it correctly.

Template: pluxml/blog/failpass
Type: error
_Description: Password input error
 The two passwords you entered were not the same. Please try again.
 
--- pluxml.old/debian/templates	2013-09-04 07:20:40.799525585 +0200
+++ pluxml/debian/templates	2013-09-14 13:39:34.375384769 +0200
@@ -6,10 +6,10 @@
  PluXml can run on any web server supporting PHP, but only listed web servers
  can be configured automatically by this package.
  .
- Please note that you will have to make sure a PHP interpreter is enabled for
- your webserver.
- .
  Please select the web servers that should be configured for PluXml.
+ .
+ Please note that you will have to make sure a PHP interpreter is enabled for
+ the webserver.
 
 Template: pluxml/system/reload-webserver
 Type: boolean
@@ -25,9 +25,9 @@
 Type: boolean
 Default: false
 _Description: Purge blog data on package removal?
- PluXml will store all your blog data in /var/lib/pluxml.
+ PluXml will store all blog data in /var/lib/pluxml.
  .
- Accepting this option will remove all the blog data when this package is
+ Accepting this option will remove all blog data when this package is
  purged, which will leave you with a tidy system but may cause data loss if you
  purge an operational blog.
 
@@ -45,16 +45,14 @@
 
 Template: pluxml/blog/lang
 Type: select
-__Choices: German (de), English (en), Spanish (es), French (fr), Italian (it), Dutch (nl), Polish (pl), Portuguese (pt), Romanian (ro), Russian (ru)
+__Choices: German, English, Spanish, French, Italian, Dutch, Polish, Portuguese, Romanian, Russian
 Choices-C: de, en, es, fr, it, nl, pl, pt, ro, ru
-# You must NOT translate this string, but you can change its value. The comment
-# between brackets is used to distinguish this msgid from the one in the
-# Choices list; you do not have to worry about them, but you simply have to
-# choose a msgstr among the language codes listed in the parentheses of the
-# English Choices above, e.g. msgstr "nl" (NOT msgstr "Dutch (nl)").
-_Default: en[ default language]
+# You must NOT translate this string, but you can change its value.
+# You should put your language (if it is among the possible choices)
+# so that it becomes the default for users of that language
+_Default: English
 _Description: Blog default language:
- Please choose the default language of your blog, which will be used for the
+ Please choose the default language of this blog, which will be used for the
  public pages.
  .
  Registered blog contributors will be able to choose their language for the
@@ -64,7 +62,7 @@
 Type: string
 Default: PluXml
 _Description: Blog title:
- Please choose a title for your blog, which will be displayed in the top of each
+ Please choose a title for this blog. It will be displayed on top of each
  page and in the browser window title.
 
 Template: pluxml/blog/description
@@ -75,7 +73,7 @@
 # (replace $LANG by your language code), under the name "L_SITE_DESCRIPTION".
 _Default: Blog or CMS, XML powered!
 _Description: Blog description or subtitle:
- Please choose a short description for your blog, which will be displayed as a
+ Please choose a short description for this blog. It will be displayed as a
  subtitle in the top of each page and in the browser window title.
 
 Template: pluxml/blog/name
@@ -92,8 +90,8 @@
 Default: admin
 _Description: Administrator user name:
  Please enter a name for the administrator account, which will be used to manage
- PluXml's configuration, users and content. The username should be composed of
- lowercase ASCII letters only.
+ PluXml's configuration, users and content. The user name should only
+ contain lowercase ASCII letters.
 
 Template: pluxml/blog/password
 Type: password
@@ -103,10 +101,11 @@
 Template: pluxml/blog/confirm
 Type: password
 _Description: Confirm password:
- Please enter the same administrator password again to verify you have typed it
- correctly.
+ Please enter the same password again to verify that you have
+ typed it correctly.
 
 Template: pluxml/blog/failpass
 Type: error
-_Description: Password mismatch
- The two passwords you entered are not identical. Please try again.
+_Description: Password input error
+ The two passwords you entered were not the same. Please try again.
+ 
--- pluxml.old/debian/control	2013-09-04 07:20:40.799525585 +0200
+++ pluxml/debian/control	2013-09-14 13:39:56.960010019 +0200
@@ -13,7 +13,7 @@
 Depends: ${shlibs:Depends}, ${misc:Depends}, ucf, php5
 Recommends: php5-gd
 Suggests: mail-transport-agent
-Description: Light blog engine using XML files
+Description: light blog engine using XML files
  PluXml is a light and simple blog and CMS engine that uses simple XML files
  to store its data and requires no database. It has all the usual features
  (static pages, comments, categories, tags, medias, RSS feed...) and supports
Source: pluxml
Section: web
Priority: extra
Maintainer: Tanguy Ortolo <tanguy+debian@ortolo.eu>
Build-Depends: debhelper (>= 8.0.0), po-debconf (>= 0.8.0), slimit
Standards-Version: 3.9.4
Homepage: http://www.pluxml.org/
Vcs-Git: git://git.ortolo.org/pkg-pluxml.git
Vcs-Browser: http://git.ortolo.org/pkg-pluxml.git

Package: pluxml
Architecture: all
Depends: ${shlibs:Depends}, ${misc:Depends}, ucf, php5
Recommends: php5-gd
Suggests: mail-transport-agent
Description: light blog engine using XML files
 PluXml is a light and simple blog and CMS engine that uses simple XML files
 to store its data and requires no database. It has all the usual features
 (static pages, comments, categories, tags, medias, RSS feed...) and supports
 multiple users, customizable themes and plugins.

Attachment: signature.asc
Description: Digital signature


Reply to: