Difference between revisions of "Website Maintenance"
(→Tips for Translators: forgot header) |
(→Intro) |
||
| Line 1: | Line 1: | ||
Sometimes something should be improved on our website. This page is intended to collect the right procedure. | Sometimes something should be improved on our website. This page is intended to collect the right procedure. | ||
| + | |||
| + | == Introduction == | ||
| + | |||
| + | '''www.gnucash.org''' is the webserver of the GnuCash project. The sources are public available at [https://github.com/Gnucash/gnucash-htdocs GitHub]. Building is done by a simple GNU Make. | ||
| + | === State === | ||
| + | <tt>{sizing|develdocs}.phtml</tt> are ''currently'' (2017) hopeless outdated. | ||
== Adding or Changing Text == | == Adding or Changing Text == | ||
| Line 7: | Line 13: | ||
=== "Coding" Style === | === "Coding" Style === | ||
| − | The static structure is usually written in HTML, the dynamic parts are injectet via PHP. | + | The static structure is usually written in [[Glossary#H|HTML]], the dynamic parts are injectet via [[Glossary#P|PHP]]. |
| + | Direct formating is disliked, use <tt>externals/gnucash.css</tT> instead. | ||
Translatable text is quoted: | Translatable text is quoted: | ||
<SyntaxHighlight lang="php"> <?php echo T_("A translatable string");?> </SyntaxHighlight> | <SyntaxHighlight lang="php"> <?php echo T_("A translatable string");?> </SyntaxHighlight> | ||
| Line 15: | Line 22: | ||
Most important are the strings from <tt>index.phtml</tt> and <tt>externals/{header|menu|footer}.phtml</tt>. They are seen, when calling the page. | Most important are the strings from <tt>index.phtml</tt> and <tt>externals/{header|menu|footer}.phtml</tt>. They are seen, when calling the page. | ||
* Strings from <tt>search/</tt> should be unusused now. | * Strings from <tt>search/</tt> should be unusused now. | ||
| − | |||
=== Managing Translations === | === Managing Translations === | ||
Revision as of 15:35, 16 February 2017
Sometimes something should be improved on our website. This page is intended to collect the right procedure.
Contents
Introduction
www.gnucash.org is the webserver of the GnuCash project. The sources are public available at GitHub. Building is done by a simple GNU Make.
State
{sizing|develdocs}.phtml are currently (2017) hopeless outdated.
Adding or Changing Text
If you add or change text, keep in mind Gnucash and its website are multilingual. If you - like me and most other people - are not firm in all languages, you should ask the translators, to help you keeping the translations up to date.
"Coding" Style
The static structure is usually written in HTML, the dynamic parts are injectet via PHP. Direct formating is disliked, use externals/gnucash.css instead. Translatable text is quoted:
<?php echo T_("A translatable string");?>
Try to avoid putting URLs in translatable strings, but links to the wiki should be separate marked translatatable - there might be a translated page in the wiki.
Tips for Translators
Most important are the strings from index.phtml and externals/{header|menu|footer}.phtml. They are seen, when calling the page.
- Strings from search/ should be unusused now.
Managing Translations
After you finished editing the english text, you should prepare the translation by
- creating a new .pot file
make pot
- msgmerge all existing .po files
make msgmerge
- and commit the updates
- send a short mail to gnucash-devel about "Translators: Website changed ..."
- feel free to give them some clues, what changed like
- "complete new download page" or
- "fixed 42 typos in the english text".
- As patches with reworked .po files arrive,
- apply them and
- make the .mo files, e.g. with
make mos
- commit
- po/LL.po and
- locale/LL/LC_MESSAGES/gnucash-htdocs.mo
- where LL is the language code.
Further details can be found on the Translation page.
Thanks for your time and work!
Todo: Testing
- Idea
- Set up apache (or another webserver?)
- Add your repository to your apache configuration /etc/apache2/conf.d/
- View http://localhost/gnucash/
