diff options
Diffstat (limited to 'README.md')
-rw-r--r-- | README.md | 122 |
1 files changed, 50 insertions, 72 deletions
@@ -1,54 +1,47 @@ | |||
1 | --- | 1 | # Overview |
2 | author: | 2 | |
3 | - Robert Alessi | 3 | This package provides for [LuaLaTeX](https://luatex.org) an |
4 | title: 'The arabluatex package -- README file' | 4 | [ArabTeX](https://ctan.org/pkg/arabtex)-like interface to generate |
5 | --- | 5 | Arabic writing from an [ascii]{.smallcaps} transliteration. It is |
6 | 6 | particularly well-suited for complex documents such as technical | |
7 | Overview | 7 | documents or critical editions where a lot of left-to-right commands |
8 | ======== | 8 | intertwine with Arabic writing. arabluatex is able to process any |
9 | 9 | ArabTeX input notation. Its output can be set in the same modes of | |
10 | This package provides for [LuaLaTeX](http://luatex.org) an | 10 | vocalization as ArabTeX, or in different roman transliterations. It |
11 | [ArabTeX](http://ctan.org/pkg/arabtex)-like interface to generate Arabic | 11 | further allows many typographical refinements. It can also operate with |
12 | writing from an [ascii]{.smallcaps} transliteration. It is particularly | 12 | the [ekdosis](https://ctan.org/pkg/ekdosis) package to produce from |
13 | well-suited for complex documents such as technical documents or | 13 | `.tex` source files, in addition to printed books, `TEI xml` compliant |
14 | critical editions where a lot of left-to-right commands intertwine with | 14 | critical editions and/or lexicons that can be searched, analyzed and |
15 | Arabic writing. arabluatex is able to process any ArabTeX input | 15 | correlated in various ways. |
16 | notation. Its output can be set in the same modes of vocalization as | 16 | |
17 | ArabTeX, or in different roman transliterations. It further allows many | 17 | # License and disclamer |
18 | typographical refinements. It will eventually interact with some other | ||
19 | packages yet to come to produce from `.tex` source files, in addition to | ||
20 | printed books, `TEI xml` compliant critical editions and/or lexicons | ||
21 | that can be searched, analyzed and correlated in various ways. | ||
22 | |||
23 | License and disclamer | ||
24 | ===================== | ||
25 | 18 | ||
26 | ArabLuaTeX -- Processing ArabTeX notation under LuaLaTeX | 19 | ArabLuaTeX -- Processing ArabTeX notation under LuaLaTeX |
27 | 20 | ||
28 | Copyright ⓒ 2016--2022 Robert Alessi | 21 | Copyright ⓒ 2016, 2017, 2018, 2019, 2020, 2021, 2022, 2023 Robert Alessi |
22 | \<`alessi@robertalessi.net`\> | ||
23 | |||
24 | Permission to use, copy, modify, and distribute this software for any | ||
25 | purpose with or without fee is hereby granted, provided that the above | ||
26 | copyright notice and this permission notice appear in all copies. | ||
27 | |||
28 | THE SOFTWARE IS PROVIDED \"AS IS\" AND THE AUTHOR DISCLAIMS ALL | ||
29 | WARRANTIES WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES | ||
30 | OF MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE | ||
31 | FOR ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY | ||
32 | DAMAGES WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER | ||
33 | IN AN ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING | ||
34 | OUT OF OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE. | ||
29 | 35 | ||
30 | Please send error reports and suggestions for improvements to Robert | 36 | Please send error reports and suggestions for improvements to Robert |
31 | Alessi: | 37 | Alessi: |
32 | 38 | ||
33 | - email: <alessi@robertalessi.net> | 39 | - email: <alessi@robertalessi.net> |
34 | 40 | ||
35 | - website: <http://www.robertalessi.net/arabluatex> | 41 | - website: <https://sr.ht/~ralessi/arabluatex> |
36 | 42 | ||
37 | - comments, feature requests, bug reports: | 43 | - comments, feature requests, bug reports: |
38 | <https://gitlab.com/ralessi/arabluatex/issues> | 44 | <https://todo.sr.ht/~ralessi/arabluatex> |
39 | |||
40 | This program is free software: you can redistribute it and/or modify it | ||
41 | under the terms of the GNU General Public License as published by the | ||
42 | Free Software Foundation, either version 3 of the License, or (at your | ||
43 | option) any later version. | ||
44 | |||
45 | This program is distributed in the hope that it will be useful, but | ||
46 | WITHOUT ANY WARRANTY; without even the implied warranty of | ||
47 | MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General | ||
48 | Public License for more details. | ||
49 | |||
50 | You should have received a copy of the GNU General Public License along | ||
51 | with this program. If not, see \<http://www.gnu.org/licenses/\>. | ||
52 | 45 | ||
53 | This release of arabluatex consists of the following source files: | 46 | This release of arabluatex consists of the following source files: |
54 | 47 | ||
@@ -66,20 +59,7 @@ This release of arabluatex consists of the following source files: | |||
66 | 59 | ||
67 | - `arabluatex_trans.lua` | 60 | - `arabluatex_trans.lua` |
68 | 61 | ||
69 | License applicable to the documentation | 62 | # Installation |
70 | --------------------------------------- | ||
71 | |||
72 | Copyright ⓒ 2016--2022 Robert Alessi | ||
73 | |||
74 | Permission is granted to copy, distribute and/or modify this document | ||
75 | under the terms of the GNU Free Documentation License, Version 1.3 or | ||
76 | any later version published by the Free Software Foundation; with no | ||
77 | Invariant Sections, no Front-Cover Texts, and no Back-Cover Texts. A | ||
78 | copy of the license is included in the section entitled "GNU Free | ||
79 | Documentation License" of the documentation. | ||
80 | |||
81 | Installation | ||
82 | ============ | ||
83 | 63 | ||
84 | 1. Run `'lualatex arabluatex.ins'` to produce the `arabluatex.sty` | 64 | 1. Run `'lualatex arabluatex.ins'` to produce the `arabluatex.sty` |
85 | file; | 65 | file; |
@@ -106,41 +86,39 @@ Installation | |||
106 | `arabluatex.el` to their `~/.emacs.d/auctex/auto` local directory. | 86 | `arabluatex.el` to their `~/.emacs.d/auctex/auto` local directory. |
107 | This will enable the appropriate hooks for ArabLuaTeX in AUCTeX. | 87 | This will enable the appropriate hooks for ArabLuaTeX in AUCTeX. |
108 | 88 | ||
109 | Development, Git Repository | 89 | # Development, Git Repository |
110 | =========================== | ||
111 | 90 | ||
112 | Browse the code | 91 | ## Browse the code |
113 | --------------- | ||
114 | 92 | ||
115 | You can browse ArabLuaTeX repository on the web: | 93 | You can browse ArabLuaTeX repository on the web: |
116 | <http://git.robertalessi.net/arabluatex> | 94 | <http://git.robertalessi.net/arabluatex>\ |
95 | or\ | ||
96 | <https://sr.ht/~ralessi/arabluatex> | ||
117 | 97 | ||
118 | From this page, you can download all the releases of ArabLuaTeX. For | 98 | From this page, you can download all the releases of ArabLuaTeX. For |
119 | instructions on how to install ArabLuaTeX, please see above. | 99 | instructions on how to install ArabLuaTeX, please see above. |
120 | 100 | ||
121 | Comments, Feature requests, Bug Reports | 101 | ## Comments, Feature requests, Bug Reports |
122 | --------------------------------------- | ||
123 | 102 | ||
124 | <https://gitlab.com/ralessi/arabluatex/issues> | 103 | <https://todo.sr.ht/~ralessi/arabluatex> |
125 | 104 | ||
126 | Download the repository | 105 | ## Download the repository |
127 | ----------------------- | ||
128 | 106 | ||
129 | ArabLuaTeX development is facilitated by git, a distributed version | 107 | ArabLuaTeX development is facilitated by git, a distributed version |
130 | control system. You will need to install git (most GNU/Linux | 108 | control system. You will need to install git (most Unix/Linux |
131 | distributions package it in their repositories). | 109 | distributions package it in their repositories). |
132 | 110 | ||
133 | Use this command to download the repository | 111 | Use this command to download the repository |
134 | 112 | ||
135 | git clone http://git.robertalessi.net/arabluatex | 113 | git clone https://git.sr.ht/~ralessi/arabluatex |
136 | 114 | ||
137 | A new directory named arabluatex will have been created, containing | 115 | A new directory named arabluatex will have been created, containing |
138 | ArabLuaTeX. | 116 | ArabLuaTeX. |
139 | 117 | ||
140 | Git hosting | 118 | ## Git hosting |
141 | ----------- | ||
142 | 119 | ||
143 | Make an account on <https://gitlab.com> and navigate (while logged in) | 120 | Make an account on <https://sr.ht> and navigate (while logged in) to |
144 | to <https://gitlab.com/ralessi/arabluatex>. Click *Fork* and you will | 121 | <https://git.sr.ht/~ralessi/arabluatex>. Click *Clone repo to your |
145 | have in your account your own repository of `arabluatex` where you will | 122 | account* and you will have in your account your own repository of |
146 | be able to make whatever changes you like to. | 123 | `arabluatex` where you will be able to make whatever changes you like |
124 | to. | ||