summaryrefslogtreecommitdiffstats
path: root/2022/talks/localizing.md
blob: 88927f26356b5c0bad9fb1cd994b6069f2a2962d (plain) (blame)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
[[!sidebar content=""]]
[[!meta title="Pre-localizing Emacs"]]
[[!meta copyright="Copyright © 2022 Jean-Christophe Helary"]]
[[!inline pages="internal(2022/info/localizing-nav)" raw="yes"]]

<!-- Initially generated with emacsconf-generate-talk-page and then left alone for manual editing -->
<!-- You can manually edit this file to update the abstract, add links, etc. --->


# Pre-localizing Emacs
Jean-Christophe Helary (he/him)

[[!inline pages="internal(2022/info/localizing-before)" raw="yes"]]
[[!template id="help"
volunteer=""
summary="Q&A could be indexed with chapter markers"
tags="help_with_chapter_markers"
message="""The Q&A session for this talk does not have chapter markers yet.
Would you like to help? See [[help_with_chapter_markers]] for more details. You can use the vidid="localizing-qanda" if adding the markers to this wiki page, or e-mail your chapter notes to <emacsconf-submit@gnu.org>."""]]


Before Emacs user-facing strings are localized to users’ languages (will that ever happen?), there are things developers must remember when including such strings in the code, and there are things that emacs-lisp beginners (like me, forever) can do to help when they face such issues.

It is not easy to write naturally flowing language when the language depends on program variables, but even if we stick to English for the time being, it is important to separate natural language from computer language as much as possible.

I will be presenting an old patch to packages.el accepted in June 2018 that took me about a year to write. The origin of the patch is a plural mistake in the packages install messages. As you can see pre-patch, the code was filled with English substrings embedded into the code to produce pasts, plurals and all sorts of English grammatical constructs.

<https://git.savannah.gnu.org/cgit/emacs.git/commit/?id=61f73703c74756e6963cc622f03bcc6938ab71b2>

Even if it is a beginner’s patch (thoroughly reviewed by dev-experts), it shows what can be done by emacs-lisp beginners to help with “straightening” the strings to reduce the number of potential English bugs and then to make Emacs strings easier to be handled by real localization processes, one day.


# Discussion

## Questions and answers

-   Q: I use Emacs on English but my mother tongue is Spanish. Is Emacs
    localized/localizable?
    -   haha I have no English knowledge to help fixing text labels, but
        it is of use for new developments.
    -   A:
-   Q: You mention regex on strings is a red flag for localization, are
    there others to look out for?
    -   A:
-   Q: So, your project is to localize all of Emacs?
    -   A:
-   Q: How deep would usefull localization go? Because at the core of
    emacs are Docstrings and localizing them could also imply localizing
    Elisp.
    -   A:

Other feedback:

- Merci Jean-Christophe ! I really enjoyed your talk (and would very much like to help localise Emacs).

[[!inline pages="internal(2022/info/localizing-after)" raw="yes"]]

[[!inline pages="internal(2022/info/localizing-nav)" raw="yes"]]