You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
 
 
 
 
 
 
nobody d9d40daec9 revision 1 week ago
..
generate-hooks-index Update github.com git repo URLs with framagit.org URLs 3 years ago
hubzilla_er bring back the schemaspy makefile 5 years ago
shredder backport waitmans changes #1170 from master 3 years ago
zotsh active relative date in sidebar profile 9 months ago
.htaccess Compatible update for .htaccess. 6 years ago
Doxyfile modify item export api call, plus a few changes from upstream 2 years ago
Doxygen.footer remove date on the footer 8 years ago
Doxygen_phpvarfilter.php 💡 Add Doxygen fix for @var member variable documentation. 4 years ago
README cleanup of really old and obsolete stuff from util 10 months ago
add_addon_repo add versioning to plugin repo 2 years ago
add_theme_repo address globbing issue in #1170 3 years ago
add_widget_repo address globbing issue in #1170 3 years ago
addons scripted replace of 'array()' with '[]' 1 month ago
admins share fixes 2 years ago
config share fixes 2 years ago
config.md document the config cli tool 8 years ago
connect cleanup of really old and obsolete stuff from util 10 months ago
db_update allow running util/db_update directly from the shell 5 months ago
dcp Deprecate the term 'master' from the codebase. 10 months ago
dmkdir split off libsync from libzot 3 years ago
docblox_errorchecker.php scripted replace of 'array()' with '[]' 1 month ago
fresh better signature handling 3 years ago
fresh.md doc cleanup 8 years ago
genhook begin hook documentation yet again 3 weeks ago
importdoc module updates 5 years ago
maintenance Bring back maintenance mode. I personally dislike this because when things go wrong you have to know that you need to disable maintenance mode manually and people never discover this until they are locked out of their sites and panicking. But we absolutely need a way to shut down server activity so we can work on it. 5 months ago
makedocs disable pcss when installing since modules don't yet work and pcss uses the view module, plus weekly doc update 8 years ago
messages.po revision 1 week ago
pconfig util/pconfig: when called with no arguments this script returns a list of local channels. That's fine, but we really shouldn't include deleted channels 2 weeks ago
php2po.php undo hmessages.po and hstrings.php hack 2 years ago
phplogtime util/phplogtime: use '-' to read from stdin 10 months ago
po2php.php cleanup of really old and obsolete stuff from util 10 months ago
precompile_smarty3.php move smarty compiled files to store/[data]/smarty3 - which puts all writeable areas of the server except the config file and logs under the "store" directory. We'll do logs at a future time. 7 years ago
run_xgettext.sh strings 10 months ago
safemode new utility: util/safemode (on or off); requires util/addons 5 years ago
schemaspy Correct directory (this runs from inside hubzilla_er 6 years ago
service_class update util/service_class to use serialise (with an s) 2 years ago
storageconv revisit the hyperdrive settings and remove some obsolete "federation" settings. 2 years ago
strings.php cleanup of really old and obsolete stuff from util 10 months ago
typo.php undo hmessages.po and hstrings.php hack 2 years ago
typohelper.php ditto for typohelper 5 years ago
udall udall - fix from upstream 2 years ago
update_addon_repo wrong test 2 years ago
update_theme_repo address globbing issue in #1170 3 years ago
update_widget_repo address globbing issue in #1170 3 years ago
zap_post cleanup of really old and obsolete stuff from util 10 months ago

README

Utilities

typo.php - is a crude syntax checker to avoid checking in files with simple
typos. It basically just loads each of our project files at once. Run from
cmdline and see if any parsing errors are reported.


Internationalisation

run_xgettext.sh - extracts translatable strings from our project files.

strings.php - a recent run of the po2php program. This provides output that
is suitable for direct inclusion in the program.

There are also translatable strings in the various files in the view/en
directory. By setting $lang = 'something' in .htconfig.php, the application
will search for view/something/filename prior to the English version in
view/en/filename when loading templates and view files.

The translated string table should be placed in view/$lang/strings.php for
automatic inclusion.

You are not restricted to using known languages. You may also use this to
translate the software into "pirate", "surfer" or merely to replace certain
text which you don't care for.

Note: The view/en directory contains many HTML template files, some of which
only have a few words of English text amongst the HTML. Over time we will move
the translation to the replace_macros() function which calls these files and
then relocate the files to the view directory. The files in the top-level view
directory are template files which do not require translation.


Placeholders

Do not translate placeholders in strings! Things like %s, %d, %1$s and $somename
are used to add dynamic content to the string.

%s represents a dynamic string, like in "Welcome to %s"
%d represents a dynamic number, like in "%d new messages"
$somename is a variable like in php
In %1$s %2$s, the numbers are the position index of multiple dynamic content.
You could swap position in string of indexed placeholders.
e.g.
"%1$s's %2$s" => "John's photo", "John's item"
"%2$s di %1$s" => "foto di John", "elemento di John"


Plural

The tt() function supports plural form. Script extract.php write this in
strings.php as an array, one string for every plural form language supports:

App::$string["%d message sent"] = Array(
0 => "%d message sent",
1 => "%d messages sent",
);

The function string_plural_select($n) defined in strings.php, return the string
index to use, related to the numbers of item (value of $n).

This is modelled after ngettext function of GNU gettext.
More info at http://www.gnu.org/software/hello/manual/gettext/Plural-forms.html


Xgettext and .po workflow

1. Run util/run_xgettext.sh script (on *unix sistems, with GNU xgettext installed)
This script runs xgettext on source tree, extracting strings from t() and tt()
functions, and creates a util/messages.po file.

% cd util; ./run_xgettext.sh ../view/{language}/messages.po

Replace {language} with the language you are working on - e.g. 'es', 'fr', 'de', etc.

2. copy util/messages.po to view/<langauage>/messages.po
3. open view/<langauage>/messages.po with a text editor and fill in infos in
"Last-Translator: FULL NAME <EMAIL@ADDRESS>"
"Language-Team: LANGUAGE <LL@li.org>\n"
"Language: \n"

(eg:
"Last-Translator: Guybrush Threepwood <gb@host.com>"
"Language-Team: Pirate Friendika <pirate-friendika-ml@host.com>\n"
"Language: pi\n"
)

For the line
"Plural-Forms: nplurals=INTEGER; plural=EXPRESSION;\n"
read GNU gettext manual at
http://www.gnu.org/software/hello/manual/gettext/Plural-forms.html

4. You could then translate the strings in text editor, but I suggest to use one
of the many .po editors out there, like QtLinguist

5. run
$ php util/po2php.php view/<language>/messages.po
to create the strings.php file

When strings are added or modified in source, you could run
$ cd util; ./run_xgettext.sh ../view/<language>/messages.po
to extract strings from source files and join them with the existing .po file:
new strings are added, the existing are not overwritten.

If you already translated the Hubzilla using strings.php, you could import your old
translation to messages.po. Run:
$ php util/php2po.php view/<language>/strings.php


You may also use the util/string_translator.php web interface to translate the string file, but it is disabled for website security reasons. The web server will need write permission to your language directories and the "Deny ..." line in util/.htaccess will need to be modified or commented to use the utility.