Grammalecte  Hex Artifact Content

Artifact a9bb1bbf947bafea536ee6bda36810eca80908b8179b14272f658082a9623f3c:


0000: 0a 23 20 48 6f 77 20 74 6f 20 62 75 69 6c 64 20  .# How to build 
0010: 47 72 61 6d 6d 61 6c 65 63 74 65 0a 0a 23 23 20  Grammalecte..## 
0020: 52 65 71 75 69 72 65 64 20 23 23 0a 0a 2a 20 50  Required ##..* P
0030: 79 74 68 6f 6e 20 33 2e 36 0a 2a 20 46 69 72 65  ython 3.6.* Fire
0040: 66 6f 78 20 4e 69 67 68 74 6c 79 0a 2a 20 4e 6f  fox Nightly.* No
0050: 64 65 4a 53 0a 20 20 2a 20 6e 70 6d 0a 20 20 2a  deJS.  * npm.  *
0060: 20 6a 70 6d 20 3a 20 68 74 74 70 73 3a 2f 2f 64   jpm : https://d
0070: 65 76 65 6c 6f 70 65 72 2e 6d 6f 7a 69 6c 6c 61  eveloper.mozilla
0080: 2e 6f 72 67 2f 65 6e 2d 55 53 2f 41 64 64 2d 6f  .org/en-US/Add-o
0090: 6e 73 2f 53 44 4b 2f 54 6f 6f 6c 73 2f 6a 70 6d  ns/SDK/Tools/jpm
00a0: 0a 20 20 2a 20 77 65 62 2d 65 78 74 20 3a 20 68  .  * web-ext : h
00b0: 74 74 70 73 3a 2f 2f 64 65 76 65 6c 6f 70 65 72  ttps://developer
00c0: 2e 6d 6f 7a 69 6c 6c 61 2e 6f 72 67 2f 66 72 2f  .mozilla.org/fr/
00d0: 41 64 64 2d 6f 6e 73 2f 57 65 62 45 78 74 65 6e  Add-ons/WebExten
00e0: 73 69 6f 6e 73 2f 47 65 74 74 69 6e 67 5f 73 74  sions/Getting_st
00f0: 61 72 74 65 64 5f 77 69 74 68 5f 77 65 62 2d 65  arted_with_web-e
0100: 78 74 0a 2a 20 54 68 75 6e 64 65 72 62 69 72 64  xt.* Thunderbird
0110: 0a 0a 0a 23 23 20 43 6f 6d 6d 61 6e 64 73 20 23  ...## Commands #
0120: 23 0a 0a 2a 2a 42 75 69 6c 64 20 61 20 6c 61 6e  #..**Build a lan
0130: 67 75 61 67 65 2a 2a 0a 0a 60 6d 61 6b 65 2e 70  guage**..`make.p
0140: 79 20 4c 41 4e 47 60 0a 0a 3e 20 47 65 6e 65 72  y LANG`..> Gener
0150: 61 74 65 20 74 68 65 20 4c 69 62 72 65 4f 66 66  ate the LibreOff
0160: 69 63 65 20 65 78 74 65 6e 73 69 6f 6e 20 61 6e  ice extension an
0170: 64 20 74 68 65 20 70 61 63 6b 61 67 65 20 66 6f  d the package fo
0180: 6c 64 65 72 2e 0a 3e 20 4c 41 4e 47 20 69 73 20  lder..> LANG is 
0190: 74 68 65 20 6c 61 6e 67 20 63 6f 64 65 20 28 49  the lang code (I
01a0: 53 4f 20 36 33 39 29 2e 0a 0a 3e 20 54 68 69 73  SO 639)...> This
01b0: 20 73 63 72 69 70 74 20 75 73 65 73 20 74 68 65   script uses the
01c0: 20 66 69 6c 65 20 60 63 6f 6e 66 69 67 2e 69 6e   file `config.in
01d0: 69 60 20 69 6e 20 74 68 65 20 66 6f 6c 64 65 72  i` in the folder
01e0: 20 60 67 63 5f 6c 61 6e 67 2f 4c 41 4e 47 60 2e   `gc_lang/LANG`.
01f0: 0a 0a 2a 2a 46 69 72 73 74 20 62 75 69 6c 64 2a  ..**First build*
0200: 2a 0a 0a 60 6d 61 6b 65 2e 70 79 20 4c 41 4e 47  *..`make.py LANG
0210: 20 2d 6a 73 60 0a 0a 3e 20 54 68 69 73 20 63 6f   -js`..> This co
0220: 6d 6d 61 6e 64 20 69 73 20 72 65 71 75 69 72 65  mmand is require
0230: 64 20 74 6f 20 67 65 6e 65 72 61 74 65 20 61 6c  d to generate al
0240: 6c 20 6e 65 63 65 73 73 61 72 79 20 66 69 6c 65  l necessary file
0250: 73 2e 0a 0a 2a 2a 4f 70 74 69 6f 6e 73 2a 2a 0a  s...**Options**.
0260: 0a 60 2d 62 20 2d 2d 62 75 69 6c 64 5f 64 61 74  .`-b --build_dat
0270: 61 60 0a 0a 3e 20 4c 61 75 6e 63 68 20 74 68 65  a`..> Launch the
0280: 20 73 63 72 69 70 74 20 60 62 75 69 6c 64 5f 64   script `build_d
0290: 61 74 61 2e 70 79 60 20 69 6e 20 74 68 65 20 66  ata.py` in the f
02a0: 6f 6c 64 65 72 20 60 67 63 5f 6c 61 6e 67 2f 4c  older `gc_lang/L
02b0: 41 4e 47 60 2e 0a 0a 60 2d 64 20 2d 2d 64 69 63  ANG`...`-d --dic
02c0: 74 60 0a 0a 3e 20 47 65 6e 65 72 61 74 65 20 74  t`..> Generate t
02d0: 68 65 20 69 6e 64 65 78 61 62 6c 65 20 62 69 6e  he indexable bin
02e0: 61 72 79 20 64 69 63 74 69 6f 6e 61 72 79 20 66  ary dictionary f
02f0: 72 6f 6d 20 74 68 65 20 6c 65 78 69 63 6f 6e 20  rom the lexicon 
0300: 69 6e 20 74 68 65 20 66 6f 6c 64 65 72 20 60 6c  in the folder `l
0310: 65 78 69 63 6f 6e 73 60 2e 0a 0a 60 2d 6a 73 20  exicons`...`-js 
0320: 2d 2d 6a 61 76 61 73 63 72 69 70 74 60 0a 0a 3e  --javascript`..>
0330: 20 41 6c 73 6f 20 67 65 6e 65 72 61 74 65 20 4a   Also generate J
0340: 61 76 61 53 63 72 69 70 74 20 65 78 74 65 6e 73  avaScript extens
0350: 69 6f 6e 73 2e 0a 3e 20 57 69 74 68 6f 75 74 20  ions..> Without 
0360: 74 68 69 73 20 6f 70 74 69 6f 6e 2c 20 6f 6e 6c  this option, onl
0370: 79 20 50 79 74 68 6f 6e 20 6d 6f 64 75 6c 65 73  y Python modules
0380: 2c 20 64 61 74 61 20 61 6e 64 20 65 78 74 65 6e  , data and exten
0390: 73 69 6f 6e 73 20 61 72 65 20 67 65 6e 65 72 61  sions are genera
03a0: 74 65 64 2e 0a 0a 60 2d 74 20 2d 2d 74 65 73 74  ted...`-t --test
03b0: 73 60 0a 0a 3e 20 52 75 6e 20 75 6e 69 74 20 74  s`..> Run unit t
03c0: 65 73 74 73 2e 0a 0a 60 2d 69 20 2d 2d 69 6e 73  ests...`-i --ins
03d0: 74 61 6c 6c 60 0a 0a 3e 20 49 6e 73 74 61 6c 6c  tall`..> Install
03e0: 20 74 68 65 20 4c 69 62 72 65 4f 66 66 69 63 65   the LibreOffice
03f0: 20 65 78 74 65 6e 73 69 6f 6e 2e 0a 0a 60 2d 66   extension...`-f
0400: 78 20 2d 2d 66 69 72 65 66 6f 78 60 0a 0a 3e 20  x --firefox`..> 
0410: 4c 61 75 6e 63 68 20 46 69 72 65 66 6f 78 20 44  Launch Firefox D
0420: 65 76 65 6c 6f 70 70 65 72 20 28 62 65 66 6f 72  evelopper (befor
0430: 65 20 46 69 72 65 66 6f 78 20 35 37 29 2e 0a 3e  e Firefox 57)..>
0440: 20 55 6e 69 74 20 74 65 73 74 73 20 63 61 6e 20   Unit tests can 
0450: 62 65 20 6c 61 6e 63 68 65 64 20 66 72 6f 6d 20  be lanched from 
0460: 46 69 72 65 66 6f 78 2c 20 77 69 74 68 20 43 54  Firefox, with CT
0470: 52 4c 2b 53 48 49 46 54 2b 46 31 32 2e 0a 0a 60  RL+SHIFT+F12...`
0480: 2d 77 65 20 2d 2d 77 65 62 65 78 74 60 0a 0a 3e  -we --webext`..>
0490: 20 4c 61 75 6e 63 68 20 46 69 72 65 66 6f 78 20   Launch Firefox 
04a0: 4e 69 67 68 74 6c 79 20 28 46 69 72 65 66 6f 78  Nightly (Firefox
04b0: 20 35 37 2b 29 2e 0a 3e 20 55 6e 69 74 20 74 65   57+)..> Unit te
04c0: 73 74 73 20 63 61 6e 20 62 65 20 6c 61 6e 63 68  sts can be lanch
04d0: 65 64 20 66 72 6f 6d 20 74 68 65 20 6d 65 6e 75  ed from the menu
04e0: 2e 0a 0a 60 2d 74 62 20 2d 2d 74 68 75 6e 64 65  ...`-tb --thunde
04f0: 72 62 69 72 64 60 0a 0a 3e 20 4c 61 75 6e 63 68  rbird`..> Launch
0500: 20 54 68 75 6e 64 65 72 62 69 72 64 2e 0a 0a 0a   Thunderbird....
0510: 23 23 20 45 78 61 6d 70 6c 65 73 20 23 23 0a 0a  ## Examples ##..
0520: 46 75 6c 6c 20 72 65 62 75 69 6c 64 3a 0a 0a 20  Full rebuild:.. 
0530: 20 20 20 20 20 20 20 6d 61 6b 65 2e 70 79 20 4c         make.py L
0540: 41 4e 47 20 2d 62 20 2d 64 20 2d 6a 73 0a 0a 41  ANG -b -d -js..A
0550: 66 74 65 72 20 6d 6f 64 69 66 79 69 6e 67 20 67  fter modifying g
0560: 72 61 6d 6d 61 72 20 72 75 6c 65 73 3a 0a 0a 20  rammar rules:.. 
0570: 20 20 20 20 20 20 20 6d 61 6b 65 2e 70 79 20 4c         make.py L
0580: 41 4e 47 20 2d 74 0a 0a 49 66 20 79 6f 75 20 6d  ANG -t..If you m
0590: 6f 64 69 66 79 20 74 68 65 20 6c 65 78 69 63 6f  odify the lexico
05a0: 6e 3a 0a 0a 20 20 20 20 20 20 20 20 6d 61 6b 65  n:..        make
05b0: 2e 70 79 20 4c 41 4e 47 20 2d 64 20 2d 6a 73 0a  .py LANG -d -js.
05c0: 0a 49 66 20 79 6f 75 20 6d 6f 64 69 66 79 20 79  .If you modify y
05d0: 6f 75 72 20 73 63 72 69 70 74 20 60 62 75 69 6c  our script `buil
05e0: 64 5f 64 61 74 61 2e 70 79 60 3a 0a 0a 20 20 20  d_data.py`:..   
05f0: 20 20 20 20 20 6d 61 6b 65 2e 70 79 20 4c 41 4e       make.py LAN
0600: 47 20 2d 62 20 2d 6a 73 0a                       G -b -js.