Re: Please review control and templates for tryton-server
Justin B Rye <[email protected]> Tue, 13 Sep 2022 18:52:05 +0100
| Newsgroups | gmane.linux.debian.internationalization.english |
|---|---|
| Message-ID | <[email protected]> |
Mathias Behrle: > I have created several new packages providing a guided support for the > installation of tryton-server. The repository can be found at > > https://salsa.debian.org/tryton-team/tryton-server/-/tree/debian-bullseye-6.0 > > As I am not a native English speaker, I would be glad to receive some feedback > for the control and templates files. Best would be to get evtl. MRs for current > working branch debian-bullseye-6.0 or patches or just comments, as you see fit. I'm starting with comments on the templates and hoping to work up towards MRs later - first I might need some help with understanding them. > Template: tryton-server-uwsgi/enable-cron (Somehow I've ended up doing these in slightly jumbled order.) > Type: boolean > Default: false > _Description: Configure cron for the Tryton server? The template name implies that the choice isn't whether they should be left uncustomised, it's whether they should run at all. So: _Description: Set up Tryton server cron jobs? > There exist several Tryton server cron jobs that mainly run periodically some > maintenance tasks on the database. They can be configured with the clients. Tryton server has several cron jobs that can be activated to perform periodic maintenance on the database. They can be configured using the Tryton clients. (I may be misinterpreting the second sentence.) > . > Note: Only one cron server should be enabled per database. Wait, is it really talking about Tryton running its own cron-daemon *server*? That also seems to be what the package description implies, but why on earth would anybody want to do that? (Is it maybe some misleadingly named task-scheduling subprocess of the Tryton server?) I'm going to assume for now that this should be something like Note: Only one maintenance cron job should be enabled per database. But maybe this is the kind of instruction that belongs in whatever interface is going to be used to pick the ones that will run? > Template: tryton-server-postgresql/db-admin-email > Type: string > Default: root@localhost > _Description: Email address for the admin user: > This email address receives all kind of administrative messages for the > admin user. Make it clear we're asking the reader to *tell* us that address. Please specify the email address that should receive administrative messages from the Tryton server. > . > The value should be a FQDN (Full Qualified Domain Name). Well, that's not true; "gmail.com." is a FQDN, but it won't work here, and on the other hand "root@localhost" isn't but will. If this is just trying to say "it won't work if it isn't valid" then it probably isn't worth saying, unless maybe we do it in passing: Please specify a valid email address that should receive administrative messages from the Tryton server. > Template: tryton-server-uwsgi/enable-workers > Type: boolean > Default: false > _Description: Configure workers for the Tryton server? Again it means "enable", not "customise": _Description: Set up Tryton server workers? > Some Tryton server tasks may be performed in the background > asynchronically by workers in a task queue. Slight reshuffle: Some Tryton server tasks can be performed asynchronously in the background by workers in a task queue. > . > If workers are configured those tasks (like e.g. the processing of sales, > invoices or purchases) can be automatically performed by workers. They > do not wait for completion in the clients thus removing the need of > waiting and doing serialized steps. Well, obviously not waiting eliminates some waiting, but it's not quite clear what's going on with the serialised steps... maybe: If enabled, the workers can automatically perform tasks such as the processing of sales, invoices, or purchases without waiting for the clients to finish, thus removing the need for serialisation. > Template: tryton-server-all-in-one/postal-code-countries > Type: multiselect > Choices: Afghanistan - AF, Albania - AL, Algeria - DZ, American Samoa - AS, Andorra - AD, Angola - AO, Anguilla - AI, Antarctica - AQ, Antigua and Barbuda - AG, Argentina - AR, Armenia - AM, Aruba - AW, Australia - AU, Austria - AT, Azerbaijan - AZ, Bahamas - BS, Bahrain - BH, Bangladesh - BD, Barbados - BB, Belarus - BY, Belgium - BE, Belize - BZ, Benin - BJ, Bermuda - BM, Bhutan - BT, Bolivia Plurinational State of - BO, Bonaire Sint Eustatius and Saba - BQ, Bosnia and Herzegovina - BA, Botswana - BW, Bouvet Island - BV, Brazil - BR, British Indian Ocean Territory - IO, Brunei Darussalam - BN, Bulgaria - BG, Burkina Faso - BF, Burundi - BI, Cabo Verde - CV, Cambodia - KH, Cameroon - CM, Canada - CA, Cayman Islands - KY, Central African Republic - CF, Chad - TD, Chile - CL, China - CN, Christmas Island - CX, Cocos (Keeling) Islands - CC, Colombia - CO, Comoros - KM, Congo The Democratic Republic of the - CD, Congo - CG, Cook Islands - CK, Costa Rica - CR, Croatia - HR, Cuba - CU, Curaçao - CW, Cyprus - CY, Czechia - CZ, Côte dIvoire - CI, Denmark - DK, Djibouti - DJ, Dominica - DM, Dominican Republic - DO, Ecuador - EC, Egypt - EG, El Salvador - SV, Equatorial Guinea - GQ, Eritrea - ER, Estonia - EE, Eswatini - SZ, Ethiopia - ET, Falkland Islands (Malvinas) - FK, Faroe Islands - FO, Fiji - FJ, Finland - FI, France - FR, French Guiana - GF, French Polynesia - PF, French Southern Territories - TF, Gabon - GA, Gambia - GM, Georgia - GE, Germany - DE, Ghana - GH, Gibraltar - GI, Greece - GR, Greenland - GL, Grenada - GD, Guadeloupe - GP, Guam - GU, Guatemala - GT, Guernsey - GG, Guinea - GN, Guinea-Bissau - GW, Guyana - GY, Haiti - HT, Heard Island and McDonald Islands - HM, Holy See (Vatican City State) - VA, Honduras - HN, Hong Kong - HK, Hungary - HU, Iceland - IS, India - IN, Indonesia - ID, Iran Islamic Republic of - IR, Iraq - IQ, Ireland - IE, Isle of Man - IM, Israel - IL, Italy - IT, Jamaica - JM, Japan - JP, Jersey - JE, Jordan - JO, Kazakhstan - KZ, Kenya - KE, Kiribati - KI, Korea Democratic Peoples Republic of - KP, Korea Republic of - KR, Kuwait - KW, Kyrgyzstan - KG, Lao Peoples Democratic Republic - LA, Latvia - LV, Lebanon - LB, Lesotho - LS, Liberia - LR, Libya - LY, Liechtenstein - LI, Lithuania - LT, Luxembourg - LU, Macao - MO, Madagascar - MG, Malawi - MW, Malaysia - MY, Maldives - MV, Mali - ML, Malta - MT, Marshall Islands - MH, Martinique - MQ, Mauritania - MR, Mauritius - MU, Mayotte - YT, Mexico - MX, Micronesia Federated States of - FM, Moldova Republic of - MD, Monaco - MC, Mongolia - MN, Montenegro - ME, Montserrat - MS, Morocco - MA, Mozambique - MZ, Myanmar - MM, Namibia - NA, Nauru - NR, Nepal - NP, Netherlands - NL, New Caledonia - NC, New Zealand - NZ, Nicaragua - NI, Niger - NE, Nigeria - NG, Niue - NU, Norfolk Island - NF, North Macedonia - MK, Northern Mariana Islands - MP, Norway - NO, Oman - OM, Pakistan - PK, Palau - PW, Palestine State of - PS, Panama - PA, Papua New Guinea - PG, Paraguay - PY, Peru - PE, Philippines - PH, Pitcairn - PN, Poland - PL, Portugal - PT, Puerto Rico - PR, Qatar - QA, Romania - RO, Russian Federation - RU, Rwanda - RW, Réunion - RE, Saint Barthélemy - BL, Saint Helena Ascension and Tristan da Cunha - SH, Saint Kitts and Nevis - KN, Saint Lucia - LC, Saint Martin (French part) - MF, Saint Pierre and Miquelon - PM, Saint Vincent and the Grenadines - VC, Samoa - WS, San Marino - SM, Sao Tome and Principe - ST, Saudi Arabia - SA, Senegal - SN, Serbia - RS, Seychelles - SC, Sierra Leone - SL, Singapore - SG, Sint Maarten (Dutch part) - SX, Slovakia - SK, Slovenia - SI, Solomon Islands - SB, Somalia - SO, South Africa - ZA, South Georgia and the South Sandwich Islands - GS, South Sudan - SS, Spain - ES, Sri Lanka - LK, Sudan - SD, Suriname - SR, Svalbard and Jan Mayen - SJ, Sweden - SE, Switzerland - CH, Syrian Arab Republic - SY, Taiwan Province of China - TW, Tajikistan - TJ, Tanzania United Republic of - TZ, Thailand - TH, Timor-Leste - TL, Togo - TG, Tokelau - TK, Tonga - TO, Trinidad and Tobago - TT, Tunisia - TN, Turkey - TR, Turkmenistan - TM, Turks and Caicos Islands - TC, Tuvalu - TV, Uganda - UG, Ukraine - UA, United Arab Emirates - AE, United Kingdom - GB, United States - US, United States Minor Outlying Islands - UM, Uruguay - UY, Uzbekistan - UZ, Vanuatu - VU, Venezuela Bolivarian Republic of - VE, Viet Nam - VN, Virgin Islands British - VG, Virgin Islands U.S. - VI, Wallis and Futuna - WF, Western Sahara - EH, Yemen - YE, Zambia - ZM, Zimbabwe - ZW, Åland Islands - AX Should all these get translations using the "__Choices" mechanism? (Sorted from A to Å by official name, with the UK and Ukraine confusingly using GB and UA? Oh well, I probably can't fix that.) > _Description: Import of postal codes > Please select all countries for which postal codes should be imported > . > Preconfigured postal codes offer automatic completion features in the address management. > . > Note: The availability of codes depends on their existence on geonames.org. I deduce that if I ask it to "import" "United Kingdom - GB", it will create a PostgreSQL table full of UK postal codes taken from geonames.org. Are they fetched at compile time or during this installation stage? There isn't really enough information here to let a reader work out what the costs would be if they enabled *all* of them. _Description: Postal codes Please select all countries for which postal codes should be imported into the database. This allows the address management system to offer automatic completion features. . Note: The availability of codes depends on their existence on geonames.org. > Template: tryton-server-postgresql/db-admin-password > Type: string > _Description: Initial admin password for Tryton: > The Tryton database will be populated with an initial superuser, named 'admin', > and the password you provide here will be used as the initial password > of this superuser. This password will be required for the first login. "Welcome to Tryton, population: 1". Simplifying slightly: A superuser account named "admin" will be created for the Tryton database. Please specify the password that this account should require for the initial login. > . > If left empty a random password will be used. You can reset this password > from the command line with > . > $ sudo -u tryton trytond-admin -c /etc/tryton/trytond.conf --password -d <your_database_name> > . > Note: The initialization of the database may take some time, please be patient. Very pedantic tweaks: If it is left empty a random password will be used. You can reset this password from the command line with . $ sudo -u tryton trytond-admin -c /etc/tryton/trytond.conf --password -d <your_database_name> . Note: The initialization of the database may take some time; please be patient. Hmm, well, I expect I've completely misunderstood at least one of them, but here are some attached revised versions. I nearly missed the package descriptions in the control file! The content looks mostly good, though the short descriptions need work and there's some inconsistent capitalisation - no time to go through commenting now, I'll just attach a first-draft modified version. -- JBR with qualifications in linguistics, experience as a Debian sysadmin, and probably no clue about this particular package
tryton-server-all-in-one.templates
(text/plain, 4.8 KB)
Template: tryton-server-all-in-one/postal-code-countries Type: multiselect Choices: Afghanistan - AF, Albania - AL, Algeria - DZ, American Samoa - AS, Andorra - AD, Angola - AO, Anguilla - AI, Antarctica - AQ, Antigua and Barbuda - AG, Argentina - AR, Armenia - AM, Aruba - AW, Australia - AU, Austria - AT, Azerbaijan - AZ, Bahamas - BS, Bahrain - BH, Bangladesh - BD, Barbados - BB, Belarus - BY, Belgium - BE, Belize - BZ, Benin - BJ, Bermuda - BM, Bhutan - BT, Bolivia Plurinational State of - BO, Bonaire Sint Eustatius and Saba - BQ, Bosnia and Herzegovina - BA, Botswana - BW, Bouvet Island - BV, Brazil - BR, British Indian Ocean Territory - IO, Brunei Darussalam - BN, Bulgaria - BG, Burkina Faso - BF, Burundi - BI, Cabo Verde - CV, Cambodia - KH, Cameroon - CM, Canada - CA, Cayman Islands - KY, Central African Republic - CF, Chad - TD, Chile - CL, China - CN, Christmas Island - CX, Cocos (Keeling) Islands - CC, Colombia - CO, Comoros - KM, Congo The Democratic Republic of the - CD, Congo - CG, Cook Islands - CK, Costa Rica - CR, Croatia - HR, Cuba - CU, Curaçao - CW, Cyprus - CY, Czechia - CZ, Côte dIvoire - CI, Denmark - DK, Djibouti - DJ, Dominica - DM, Dominican Republic - DO, Ecuador - EC, Egypt - EG, El Salvador - SV, Equatorial Guinea - GQ, Eritrea - ER, Estonia - EE, Eswatini - SZ, Ethiopia - ET, Falkland Islands (Malvinas) - FK, Faroe Islands - FO, Fiji - FJ, Finland - FI, France - FR, French Guiana - GF, French Polynesia - PF, French Southern Territories - TF, Gabon - GA, Gambia - GM, Georgia - GE, Germany - DE, Ghana - GH, Gibraltar - GI, Greece - GR, Greenland - GL, Grenada - GD, Guadeloupe - GP, Guam - GU, Guatemala - GT, Guernsey - GG, Guinea - GN, Guinea-Bissau - GW, Guyana - GY, Haiti - HT, Heard Island and McDonald Islands - HM, Holy See (Vatican City State) - VA, Honduras - HN, Hong Kong - HK, Hungary - HU, Iceland - IS, India - IN, Indonesia - ID, Iran Islamic Republic of - IR, Iraq - IQ, Ireland - IE, Isle of Man - IM, Israel - IL, Italy - IT, Jamaica - JM, Japan - JP, Jersey - JE, Jordan - JO, Kazakhstan - KZ, Kenya - KE, Kiribati - KI, Korea Democratic Peoples Republic of - KP, Korea Republic of - KR, Kuwait - KW, Kyrgyzstan - KG, Lao Peoples Democratic Republic - LA, Latvia - LV, Lebanon - LB, Lesotho - LS, Liberia - LR, Libya - LY, Liechtenstein - LI, Lithuania - LT, Luxembourg - LU, Macao - MO, Madagascar - MG, Malawi - MW, Malaysia - MY, Maldives - MV, Mali - ML, Malta - MT, Marshall Islands - MH, Martinique - MQ, Mauritania - MR, Mauritius - MU, Mayotte - YT, Mexico - MX, Micronesia Federated States of - FM, Moldova Republic of - MD, Monaco - MC, Mongolia - MN, Montenegro - ME, Montserrat - MS, Morocco - MA, Mozambique - MZ, Myanmar - MM, Namibia - NA, Nauru - NR, Nepal - NP, Netherlands - NL, New Caledonia - NC, New Zealand - NZ, Nicaragua - NI, Niger - NE, Nigeria - NG, Niue - NU, Norfolk Island - NF, North Macedonia - MK, Northern Mariana Islands - MP, Norway - NO, Oman - OM, Pakistan - PK, Palau - PW, Palestine State of - PS, Panama - PA, Papua New Guinea - PG, Paraguay - PY, Peru - PE, Philippines - PH, Pitcairn - PN, Poland - PL, Portugal - PT, Puerto Rico - PR, Qatar - QA, Romania - RO, Russian Federation - RU, Rwanda - RW, Réunion - RE, Saint Barthélemy - BL, Saint Helena Ascension and Tristan da Cunha - SH, Saint Kitts and Nevis - KN, Saint Lucia - LC, Saint Martin (French part) - MF, Saint Pierre and Miquelon - PM, Saint Vincent and the Grenadines - VC, Samoa - WS, San Marino - SM, Sao Tome and Principe - ST, Saudi Arabia - SA, Senegal - SN, Serbia - RS, Seychelles - SC, Sierra Leone - SL, Singapore - SG, Sint Maarten (Dutch part) - SX, Slovakia - SK, Slovenia - SI, Solomon Islands - SB, Somalia - SO, South Africa - ZA, South Georgia and the South Sandwich Islands - GS, South Sudan - SS, Spain - ES, Sri Lanka - LK, Sudan - SD, Suriname - SR, Svalbard and Jan Mayen - SJ, Sweden - SE, Switzerland - CH, Syrian Arab Republic - SY, Taiwan Province of China - TW, Tajikistan - TJ, Tanzania United Republic of - TZ, Thailand - TH, Timor-Leste - TL, Togo - TG, Tokelau - TK, Tonga - TO, Trinidad and Tobago - TT, Tunisia - TN, Turkey - TR, Turkmenistan - TM, Turks and Caicos Islands - TC, Tuvalu - TV, Uganda - UG, Ukraine - UA, United Arab Emirates - AE, United Kingdom - GB, United States - US, United States Minor Outlying Islands - UM, Uruguay - UY, Uzbekistan - UZ, Vanuatu - VU, Venezuela Bolivarian Republic of - VE, Viet Nam - VN, Virgin Islands British - VG, Virgin Islands U.S. - VI, Wallis and Futuna - WF, Western Sahara - EH, Yemen - YE, Zambia - ZM, Zimbabwe - ZW, Åland Islands - AX _Description: Postal codes Please select all countries for which postal codes should be imported. This allows the address management system to offer automatic completion features. . Note: The availability of codes depends on their existence on geonames.org.
tryton-server-postgresql.templates
(text/plain, 814 B)
Template: tryton-server-postgresql/db-admin-password Type: string _Description: Initial admin password for Tryton: A superuser account named "admin" will be created for the Tryton database. Please specify the password that this account should require for the initial login. . If it is left empty a random password will be used. You can reset this password from the command line with . $ sudo -u tryton trytond-admin -c /etc/tryton/trytond.conf --password -d <your_database_name> . Note: The initialization of the database may take some time; please be patient. Template: tryton-server-postgresql/db-admin-email Type: string Default: root@localhost _Description: Email address for the admin user: Please specify a valid email address that should receive administrative messages from the Tryton server.
tryton-server-uwsgi.templates
(text/plain, 776 B)
Template: tryton-server-uwsgi/enable-workers Type: boolean Default: false _Description: Set up Tryton server workers? Some Tryton server tasks can be performed asynchronously in the background by workers in a task queue. . If enabled, the workers can automatically perform tasks such as the processing of sales, invoices, or purchases without waiting for the clients to finish, thus removing the need for serialisation. Template: tryton-server-uwsgi/enable-cron Type: boolean Default: false _Description: Set up Tryton server cron jobs? Tryton server has several cron jobs that can be activated to perform periodic maintenance on the database. They can be configured using the Tryton clients. . Note: Only one maintenance cron job should be enabled per database.
control
(text/plain, 6.7 KB)
Source: tryton-server Maintainer: Debian Tryton Maintainers <[email protected]> Uploaders: Mathias Behrle <[email protected]> Section: python Priority: optional Build-Depends: debhelper-compat (= 13), dh-python, init-system-helpers (>= 1.51), po-debconf, python3, python3-bcrypt, python3-dateutil, python3-defusedxml, python3-genshi, python3-lxml, python3-mock, python3-passlib, python3-pil, python3-polib, python3-relatorio (>= 0.7), python3-setuptools, python3-sphinx, python3-sql, python3-werkzeug, python3-wrapt Standards-Version: 4.6.1 Rules-Requires-Root: no Vcs-Browser: https://salsa.debian.org/tryton-team/tryton-server Vcs-Git: https://salsa.debian.org/tryton-team/tryton-server.git Homepage: http://www.tryton.org/ Package: tryton-server Architecture: all Pre-Depends: ${misc:Pre-Depends} Depends: adduser, lsb-base, python3-bcrypt, python3-dateutil, python3-defusedxml, python3-genshi, python3-lxml, python3-pkg-resources, python3-passlib, python3-polib, python3-relatorio (>= 0.7), python3-sql, python3-werkzeug, python3-wrapt, ucf, ${misc:Depends}, ${python3:Depends} Recommends: default-mta | mail-transport-agent, libreoffice-calc, libreoffice-writer, postgresql, python3-gevent, python3-html2text, python3-levenshtein, python3-pil, python3-psycopg2, python3-pydot, python3-weasyprint, ssl-cert Suggests: postgresql-client, python3-sphinx, tryton-client, tryton-modules-all, tryton-server-doc Provides: ${API} Description: Tryton application platform - server Tryton is a high-level general purpose application platform. It is the base of a complete business solution as well as a comprehensive health and hospital information system (GNUHealth). It is written in Python and uses PostgreSQL as its preferred database engine. . This package contains the server. Package: tryton-server-doc Architecture: all Section: doc Depends: ${misc:Depends}, ${sphinxdoc:Depends} Description: Tryton application platform - server documentation Tryton is a high-level general purpose application platform. It is the base of a complete business solution as well as a comprehensive health and hospital information system (GNUHealth). It is written in Python and uses PostgreSQL as its preferred database engine. . This package contains the documentation of the server in HTML format. Package: tryton-server-postgresql Architecture: all Depends: ${API}, dbconfig-pgsql | dbconfig-no-thanks, python3-psycopg2, tryton-server, ucf, ${misc:Depends} Suggests: postgresql, autopostgresqlbackup Description: Tryton application platform - PostgreSQL integration Tryton is a high-level general purpose application platform. It is the base of a complete business solution as well as a comprehensive health and hospital information system (GNUHealth). . The default database backend of the Tryton server is SQLite3, but for production use PostgreSQL is the preferred and recommended database engine. . This package provides the integration of tryton-server with PostgreSQL. Package: tryton-server-uwsgi Architecture: all Depends: ${API}, tryton-server, ucf, uwsgi-plugin-python3, ${misc:Depends} Recommends: tryton-server-postgresql Suggests: tryton-server-nginx Description: Tryton application platform - uWSGI integration Tryton is a high-level general purpose application platform. It is the base of a complete business solution as well as a comprehensive health and hospital information system (GNUHealth). . For production use it is recommended to run the Tryton server under a WSGI backend instead of the simple werkzeug development server. . This package provides the integration of tryton-server with the uWSGI backend. It offers also the possibility to configure and run workers and/or cron as uWSGI daemons. . The Tryton server can be accessed by the uWSGI and/or the HTTP protocol. For small sites that are not exposed to the Internet this may already cover your needs; otherwise have a look at the package tryton-server-nginx to run the uWSGI server behind a dedicated reverse proxy. Package: tryton-server-nginx Architecture: all Depends: ${API}, python3-certbot-nginx | nginx, tryton-server-uwsgi, ucf, ${misc:Depends} Suggests: tryton-server-postgresql Description: Tryton application platform - Nginx integration Tryton is a high-level general purpose application platform. It is the base of a complete business solution as well as a comprehensive health and hospital information system (GNUHealth). . While the uWSGI server as WSGI backend offers the possibility to serve HTTP content it is still preferable to expose the content produced by the Tryton server via HTTPS with a dedicated web frontend like Nginx on top of a robust WSGI application. Nginx has decent default security settings, is able to talk to WSGI applications by the native WSGI protocol, and also offers features like caching of dynamic content, load balancing, serving static resources. . This package provides the integration of tryton-server-uwsgi with Nginx. Package: tryton-server-all-in-one Architecture: all Depends: ${API}, python3-pycountry, tryton-proteus, tryton-server, tryton-server-nginx, tryton-server-postgresql, tryton-server-uwsgi, tryton-modules-country, tryton-modules-currency, ${misc:Depends} Recommends: tryton-client-doc, tryton-modules-all, tryton-server-doc Description: Tryton application platform - metapackage Tryton is a high-level general purpose application platform. It is the base of a complete business solution as well as a comprehensive health and hospital information system (GNUHealth). . This package offers the complete guided production grade setup of a Tryton server installation. It will provide - the guided configuration and creation of the PostgreSQL database - the guided setup of a uWSGI backend - the guided setup of an Nginx frontend with the optional registration and setup of Letsencrypt certificates - a preconfigured PostgreSQL database prefilled with static data such as countries, currencies, and postal codes ready for use