1 |
adx |
30 |
Message Customization Overview |
2 |
|
|
|
3 |
knight |
31 |
$Id$ |
4 |
adx |
30 |
|
5 |
|
|
Copyright (c) 2005 by ircd-hybrid team |
6 |
|
|
|
7 |
|
|
---------------------------------------------------------------------- |
8 |
|
|
|
9 |
|
|
Hybrid now supports its own .lang format for i18n'd IRC status messages. |
10 |
|
|
|
11 |
|
|
This document is split into two parts, using message files, and creating |
12 |
|
|
your own. |
13 |
|
|
|
14 |
|
|
---------------------------------------------------------------------- |
15 |
|
|
|
16 |
|
|
Using Provided or Pre-made Message Files |
17 |
|
|
|
18 |
|
|
There are a number of message files provided with Hybrid 7. These can be |
19 |
|
|
found in the source tree in messages/. |
20 |
|
|
|
21 |
|
|
These files are NOT installed by default; run `make install' within the |
22 |
|
|
messages directory to install them and they will automatically be used |
23 |
|
|
unless the paths in defaults.h were not adhered to. |
24 |
|
|
|
25 |
|
|
These message files can be used in ircd once they are installed. Try the |
26 |
|
|
installed message file with /quote SET MSGLOCALE <locale> first. The |
27 |
|
|
locale will be 'standard' for the plain messages that are Hybrid's |
28 |
|
|
default. |
29 |
|
|
|
30 |
|
|
If the desired message file works without any issues, it can be set to be |
31 |
|
|
the default message file in the ircd.conf file. Refer to example.conf's |
32 |
|
|
documentation on the message_locale setting. |
33 |
|
|
|
34 |
|
|
---------------------------------------------------------------------- |
35 |
|
|
|
36 |
|
|
Creating Your Own Messages |
37 |
|
|
|
38 |
|
|
This process is a little more complicated. The easiest way to start |
39 |
|
|
editing messages is to take ircd-standard.example.lang, make a copy, |
40 |
|
|
and change whichever status lines you wish. |
41 |
|
|
|
42 |
|
|
Once you have your customized message file ready, just copy it into the |
43 |
|
|
same place as the rest of the messages, typically $PREFIX/messages. |
44 |
|
|
|
45 |
|
|
If you think your .lang file deserves to be in the official distribution, |
46 |
|
|
submit it to us at bugs@ircd-hybrid.org. It must be complete and as error- |
47 |
|
|
free as you can make it since it is subject to public consumption. Providing |
48 |
|
|
a translation will be a way that nearly anyone who knows multiple languages |
49 |
|
|
to contribute to ircd, and get their name in the translation credits. |
50 |
|
|
|
51 |
|
|
When making such a translation, you should base it off |
52 |
|
|
ircd-standard.example.lang, which is a conversion of our base (English) |
53 |
|
|
messages.tab into the .lang format. You should edit it from there into your |
54 |
|
|
own language, and of course give credit to yourself and whoever else you |
55 |
|
|
may have done the translation with. Then, send it off to us, and we'll see |
56 |
|
|
what we can do. |