diff options
-rw-r--r-- | Makefile | 15 | ||||
-rw-r--r-- | README.md | 12 | ||||
-rw-r--r-- | about.html | 7 | ||||
-rw-r--r-- | icite.dtx | 204 | ||||
-rw-r--r-- | icite.ins | 11 |
5 files changed, 40 insertions, 209 deletions
@@ -4,6 +4,7 @@ PWD = $(shell pwd) | |||
4 | VERS = $(shell ltxfileinfo -v $(NAME).dtx|sed -e 's/^v//') | 4 | VERS = $(shell ltxfileinfo -v $(NAME).dtx|sed -e 's/^v//') |
5 | LOCAL = $(shell kpsewhich --var-value TEXMFLOCAL) | 5 | LOCAL = $(shell kpsewhich --var-value TEXMFLOCAL) |
6 | UTREE = $(shell kpsewhich --var-value TEXMFHOME) | 6 | UTREE = $(shell kpsewhich --var-value TEXMFHOME) |
7 | CMP = lualatex-dev | ||
7 | 8 | ||
8 | exts := md bib ins dtx html | 9 | exts := md bib ins dtx html |
9 | texsamples := $(basename $(wildcard $(PWD)/samples/*.tex)) | 10 | texsamples := $(basename $(wildcard $(PWD)/samples/*.tex)) |
@@ -23,9 +24,13 @@ define dosamples | |||
23 | lualatex --output-dir=$(PWD)/TMP --shell-escape $1 >/dev/null | 24 | lualatex --output-dir=$(PWD)/TMP --shell-escape $1 >/dev/null |
24 | endef | 25 | endef |
25 | 26 | ||
26 | all: $(NAME).pdf | 27 | sty: clean |
28 | $(CMP) $(NAME).ins | ||
29 | |||
30 | all: clean sty $(NAME).pdf | ||
27 | # test -e README.md || exit 0 | 31 | # test -e README.md || exit 0 |
28 | $(NAME).pdf: $(NAME).dtx | 32 | |
33 | $(NAME).pdf: clean sty $(NAME).dtx | ||
29 | @ echo "Make documentation..." | 34 | @ echo "Make documentation..." |
30 | lualatex --shell-escape --recorder --interaction=batchmode $(NAME).dtx >/dev/null | 35 | lualatex --shell-escape --recorder --interaction=batchmode $(NAME).dtx >/dev/null |
31 | biber $(NAME) >/dev/null | 36 | biber $(NAME) >/dev/null |
@@ -42,7 +47,7 @@ $(NAME).pdf: $(NAME).dtx | |||
42 | $(foreach file,$(texsamples), $(call dosamples, $(file))) | 47 | $(foreach file,$(texsamples), $(call dosamples, $(file))) |
43 | mv TMP/*.pdf samples/ | 48 | mv TMP/*.pdf samples/ |
44 | 49 | ||
45 | samples: | 50 | samples: clean sty |
46 | if [ ! -d $(PWD)/TMP ]; then mkdir $(PWD)/TMP; fi | 51 | if [ ! -d $(PWD)/TMP ]; then mkdir $(PWD)/TMP; fi |
47 | cp $(PWD)/samples/*.bib $(PWD)/TMP | 52 | cp $(PWD)/samples/*.bib $(PWD)/TMP |
48 | $(foreach file,$(texsamples), $(call dosamples, $(file))) | 53 | $(foreach file,$(texsamples), $(call dosamples, $(file))) |
@@ -51,7 +56,7 @@ samples: | |||
51 | lualatex: | 56 | lualatex: |
52 | lualatex --shell-escape --recorder --interaction=batchmode $(NAME).dtx >/dev/null | 57 | lualatex --shell-escape --recorder --interaction=batchmode $(NAME).dtx >/dev/null |
53 | 58 | ||
54 | clean: lualatex | 59 | clean: |
55 | rm -f $(NAME).bib $(PWD)/TMP/*.bib | 60 | rm -f $(NAME).bib $(PWD)/TMP/*.bib |
56 | rm -rf .backup | 61 | rm -rf .backup |
57 | find -iname "*~" -or -iname "*.pdf" | xargs rm -rf | 62 | find -iname "*~" -or -iname "*.pdf" | xargs rm -rf |
@@ -95,7 +100,7 @@ zip: all | |||
95 | 100 | ||
96 | package: distclean all | 101 | package: distclean all |
97 | mkdir $(NAME)/ | 102 | mkdir $(NAME)/ |
98 | cp Makefile README.md $(NAME).{dtx,pdf} $(NAME)/ | 103 | cp Makefile README.md $(NAME).{ins,dtx,pdf} $(NAME)/ |
99 | cp -r samples/ $(NAME)/ | 104 | cp -r samples/ $(NAME)/ |
100 | mkdir -p tex/latex/$(NAME)/ | 105 | mkdir -p tex/latex/$(NAME)/ |
101 | cp $(NAME).sty tex/latex/$(NAME)/ | 106 | cp $(NAME).sty tex/latex/$(NAME)/ |
@@ -46,9 +46,7 @@ This release of icite consists of the following source files: | |||
46 | 46 | ||
47 | - `icite.dtx` | 47 | - `icite.dtx` |
48 | 48 | ||
49 | - `icite.ins` (As this file can be generated from `icite.dtx`, it is | 49 | - `icite.ins` |
50 | not included in CTAN repository, but it is included in the git | ||
51 | repository mentioned below for easier installation.) | ||
52 | 50 | ||
53 | - `Makefile` | 51 | - `Makefile` |
54 | 52 | ||
@@ -66,14 +64,10 @@ a letter to Creative Commons, PO Box 1866, Mountain View, CA 94042, USA. | |||
66 | Installation | 64 | Installation |
67 | ============ | 65 | ============ |
68 | 66 | ||
69 | 1. If `icite` was downloaded from CTAN, run `'lualatex --shell-escape | 67 | 1. Run `'latex icite.ins'` to produce the `icite.sty` file. |
70 | icite.dtx'` to produce the `icite.sty` file. | ||
71 | |||
72 | If `icite` was downloaded from the git repository mentioned above, | ||
73 | Run `'latex icite.ins'` to produce the `icite.sty` file. | ||
74 | 68 | ||
75 | 2. To finish the installation you have to move the `icite.sty` file into | 69 | 2. To finish the installation you have to move the `icite.sty` file into |
76 | a directory where LaTeX can find them. See the FAQ on `texfaq.org` | 70 | a directory where LaTeX can find it. See the FAQ on `texfaq.org` |
77 | at <https://texfaq.org/FAQ-inst-wlcf> for more on this. | 71 | at <https://texfaq.org/FAQ-inst-wlcf> for more on this. |
78 | 72 | ||
79 | Development, Git Repository | 73 | Development, Git Repository |
@@ -30,7 +30,7 @@ | |||
30 | <p>This release of icite consists of the following source files:</p> | 30 | <p>This release of icite consists of the following source files:</p> |
31 | <ul> | 31 | <ul> |
32 | <li><p><code>icite.dtx</code></p></li> | 32 | <li><p><code>icite.dtx</code></p></li> |
33 | <li><p><code>icite.ins</code> (As this file can be generated from <code>icite.dtx</code>, it is not included in CTAN repository, but it is included in the git repository mentioned below for easier installation.)</p></li> | 33 | <li><p><code>icite.ins</code></p></li> |
34 | <li><p><code>Makefile</code></p></li> | 34 | <li><p><code>Makefile</code></p></li> |
35 | </ul> | 35 | </ul> |
36 | <h2 id="license-applicable-to-the-documentation">License applicable to the documentation</h2> | 36 | <h2 id="license-applicable-to-the-documentation">License applicable to the documentation</h2> |
@@ -38,9 +38,8 @@ | |||
38 | <p>The documentation file <code>icite.pdf</code> that is generated from the <code>icite.dtx</code> source file is licensed under the Creative Commons Attribution-ShareAlike 4.0 International License. To view a copy of this license, visit <a href="http://creativecommons.org/licenses/by-sa/4.0/" class="uri">http://creativecommons.org/licenses/by-sa/4.0/</a> or send a letter to Creative Commons, PO Box 1866, Mountain View, CA 94042, USA.</p> | 38 | <p>The documentation file <code>icite.pdf</code> that is generated from the <code>icite.dtx</code> source file is licensed under the Creative Commons Attribution-ShareAlike 4.0 International License. To view a copy of this license, visit <a href="http://creativecommons.org/licenses/by-sa/4.0/" class="uri">http://creativecommons.org/licenses/by-sa/4.0/</a> or send a letter to Creative Commons, PO Box 1866, Mountain View, CA 94042, USA.</p> |
39 | <h1 id="installation">Installation</h1> | 39 | <h1 id="installation">Installation</h1> |
40 | <ol style="list-style-type: decimal"> | 40 | <ol style="list-style-type: decimal"> |
41 | <li><p>If <code>icite</code> was downloaded from CTAN, run <code>'lualatex --shell-escape icite.dtx'</code> to produce the <code>icite.sty</code> file.</p> | 41 | <li><p>Run <code>'latex icite.ins'</code> to produce the <code>icite.sty</code> file.</p></li> |
42 | <p>If <code>icite</code> was downloaded from the git repository mentioned above, Run <code>'latex icite.ins'</code> to produce the <code>icite.sty</code> file.</p></li> | 42 | <li><p>To finish the installation you have to move the <code>icite.sty</code> file into a directory where LaTeX can find it. See the FAQ on <code>texfaq.org</code> at <a href="https://texfaq.org/FAQ-inst-wlcf" class="uri">https://texfaq.org/FAQ-inst-wlcf</a> for more on this.</p></li> |
43 | <li><p>To finish the installation you have to move the <code>icite.sty</code> file into a directory where LaTeX can find them. See the FAQ on <code>texfaq.org</code> at <a href="https://texfaq.org/FAQ-inst-wlcf" class="uri">https://texfaq.org/FAQ-inst-wlcf</a> for more on this.</p></li> | ||
44 | </ol> | 43 | </ol> |
45 | <h1 id="development-git-repository">Development, Git Repository</h1> | 44 | <h1 id="development-git-repository">Development, Git Repository</h1> |
46 | <h2 id="browse-the-code">Browse the code</h2> | 45 | <h2 id="browse-the-code">Browse the code</h2> |
@@ -1,189 +1,23 @@ | |||
1 | % \iffalse meta-comment | 1 | % \iffalse meta-comment |
2 | % vim: textwidth=75 | 2 | % icite -- Indices locorum citatorum |
3 | %<*internal> | 3 | % Copyright (C) 2016--2020 Robert Alesssi |
4 | \iffalse | 4 | % |
5 | %</internal> | 5 | % Please send error reports and suggestions for improvements to Robert |
6 | %<*readme> | 6 | % Alessi <alessi@robertalessi.net> |
7 | --- | 7 | % |
8 | author: | 8 | % This program is free software: you can redistribute it and/or modify |
9 | - Robert Alessi | 9 | % it under the terms of the GNU General Public License as published by |
10 | title: 'The icite package – README file' | 10 | % the Free Software Foundation, either version 3 of the License, or |
11 | --- | 11 | % (at your option) any later version. |
12 | 12 | % | |
13 | Overview | 13 | % This program is distributed in the hope that it will be useful, but |
14 | ======== | 14 | % WITHOUT ANY WARRANTY; without even the implied warranty of |
15 | 15 | % MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU | |
16 | `icite` is designed to produce from BibTeX or BibLaTeX bibliographical | 16 | % General Public License for more details. |
17 | databases the different indices of authors and works cited which are | 17 | % |
18 | called _indices locorum citatorum_. It relies on a specific | 18 | % You should have received a copy of the GNU General Public License |
19 | `\icite` command and can operate with either BibTeX or BibLaTeX. | 19 | % along with this program. If not, see |
20 | 20 | % <http://www.gnu.org/licenses/>. | |
21 | License and disclamer | ||
22 | ===================== | ||
23 | |||
24 | icite – Indices locorum citatorum | ||
25 | |||
26 | Copyright ⓒ 2019--2020 Robert Alessi | ||
27 | |||
28 | Please send error reports and suggestions for improvements to Robert | ||
29 | Alessi: | ||
30 | |||
31 | - email: <alessi@robertalessi.net> | ||
32 | |||
33 | - website: <http://www.robertalessi.net/icite> | ||
34 | |||
35 | - comments, feature requests, bug reports: | ||
36 | <https://gitlab.com/ralessi/icite/issues> | ||
37 | |||
38 | This program is free software: you can redistribute it and/or modify it | ||
39 | under the terms of the GNU General Public License as published by the | ||
40 | Free Software Foundation, either version 3 of the License, or (at your | ||
41 | option) any later version. | ||
42 | |||
43 | This program is distributed in the hope that it will be useful, but | ||
44 | WITHOUT ANY WARRANTY; without even the implied warranty of | ||
45 | MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General | ||
46 | Public License for more details. | ||
47 | |||
48 | You should have received a copy of the GNU General Public License along | ||
49 | with this program. If not, see <http://www.gnu.org/licenses/>. | ||
50 | |||
51 | This release of icite consists of the following source files: | ||
52 | |||
53 | - `icite.dtx` | ||
54 | |||
55 | - `icite.ins` (As this file can be generated from `icite.dtx`, it is | ||
56 | not included in CTAN repository, but it is included in the git | ||
57 | repository mentioned below for easier installation.) | ||
58 | |||
59 | - `Makefile` | ||
60 | |||
61 | License applicable to the documentation | ||
62 | --------------------------------------- | ||
63 | |||
64 | Copyright ⓒ 2019--2020 Robert Alessi | ||
65 | |||
66 | The documentation file `icite.pdf` that is generated from the | ||
67 | `icite.dtx` source file is licensed under the Creative Commons | ||
68 | Attribution-ShareAlike 4.0 International License. To view a copy of this | ||
69 | license, visit <http://creativecommons.org/licenses/by-sa/4.0/> or send | ||
70 | a letter to Creative Commons, PO Box 1866, Mountain View, CA 94042, USA. | ||
71 | |||
72 | Installation | ||
73 | ============ | ||
74 | |||
75 | 1. If `icite` was downloaded from CTAN, run `'lualatex --shell-escape | ||
76 | icite.dtx'` to produce the `icite.sty` file. | ||
77 | |||
78 | If `icite` was downloaded from the git repository mentioned above, | ||
79 | Run `'latex icite.ins'` to produce the `icite.sty` file. | ||
80 | |||
81 | 2. To finish the installation you have to move the `icite.sty` file into | ||
82 | a directory where LaTeX can find them. See the FAQ on `texfaq.org` | ||
83 | at <https://texfaq.org/FAQ-inst-wlcf> for more on this. | ||
84 | |||
85 | |||
86 | Development, Git Repository | ||
87 | =========================== | ||
88 | |||
89 | Browse the code | ||
90 | --------------- | ||
91 | |||
92 | You can browse icite repository on the web: | ||
93 | <http://git.robertalessi.net/icite> | ||
94 | |||
95 | From this page, you can download all the releases of `icite`. For | ||
96 | instructions on how to install `icite`, please see above. | ||
97 | |||
98 | Comments, Feature requests, Bug Reports | ||
99 | --------------------------------------- | ||
100 | |||
101 | <https://gitlab.com/ralessi/icite/issues> | ||
102 | |||
103 | Download the repository | ||
104 | ----------------------- | ||
105 | |||
106 | `icite` development is facilitated by git, a distributed version | ||
107 | control system. You will need to install git (most GNU/Linux | ||
108 | distributions package it in their repositories). | ||
109 | |||
110 | Use this command to download the repository | ||
111 | |||
112 | git clone http://git.robertalessi.net/icite | ||
113 | |||
114 | A new directory named icite will have been created, containing | ||
115 | `icite`. | ||
116 | |||
117 | Git hosting | ||
118 | ----------- | ||
119 | |||
120 | Make an account on <https://gitlab.com> and navigate (while logged in) | ||
121 | to <https://gitlab.com/ralessi/icite>. Click *Fork* and you will | ||
122 | have in your account your own repository of `icite` where you will | ||
123 | be able to make whatever changes you like to. | ||
124 | |||
125 | %</readme> | ||
126 | %<*internal> | ||
127 | \fi | ||
128 | \def\nameofplainTeX{plain} | ||
129 | \ifx\fmtname\nameofplainTeX\else | ||
130 | \expandafter\begingroup | ||
131 | \fi | ||
132 | %</internal> | ||
133 | %<*install> | ||
134 | \input docstrip.tex | ||
135 | \keepsilent | ||
136 | \askforoverwritefalse | ||
137 | \preamble | ||
138 | |||
139 | Copyright (C) 2019-2020 by Robert Alessi <alessi@robertalessi.net> | ||
140 | |||
141 | Please send error reports and suggestions for improvements to Robert | ||
142 | Alessi <alessi@robertalessi.net> | ||
143 | |||
144 | This program is free software: you can redistribute it and/or modify | ||
145 | it under the terms of the GNU General Public License as published by | ||
146 | the Free Software Foundation, either version 3 of the License, or | ||
147 | (at your option) any later version. | ||
148 | |||
149 | This program is distributed in the hope that it will be useful, but | ||
150 | WITHOUT ANY WARRANTY; without even the implied warranty of | ||
151 | MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU | ||
152 | General Public License for more details. | ||
153 | |||
154 | You should have received a copy of the GNU General Public License | ||
155 | along with this program. If not, see | ||
156 | <http://www.gnu.org/licenses/>. | ||
157 | |||
158 | This work consists of the file icite.dtx, icite.ins and a Makefile. | ||
159 | Running "make" generates the derived files README.md, icite.pdf and icite.sty. | ||
160 | Running "make inst" installs the files in the user's TeX tree. | ||
161 | Running "make install" installs the files in the local TeX tree. | ||
162 | |||
163 | \endpreamble | ||
164 | |||
165 | \usedir{tex/latex/icite} | ||
166 | \generate{ | ||
167 | \file{\jobname.sty}{\from{\jobname.dtx}{package}} | ||
168 | } | ||
169 | %</install> | ||
170 | %<install>\endbatchfile | ||
171 | %<*internal> | ||
172 | \usedir{source/latex/icite} | ||
173 | \generate{ | ||
174 | \file{\jobname.ins}{\from{\jobname.dtx}{install}} | ||
175 | } | ||
176 | \nopreamble\nopostamble | ||
177 | \usedir{doc/latex/icite} | ||
178 | \generate{ | ||
179 | \file{README.md}{\from{\jobname.dtx}{readme}} | ||
180 | } | ||
181 | \ifx\fmtname\nameofplainTeX | ||
182 | \expandafter\endbatchfile | ||
183 | \else | ||
184 | \expandafter\endgroup | ||
185 | \fi | ||
186 | %</internal> | ||
187 | % \fi | 21 | % \fi |
188 | % | 22 | % |
189 | % \iffalse | 23 | % \iffalse |
@@ -1,10 +1,6 @@ | |||
1 | %% | 1 | %% |
2 | %% This is file `icite.ins', | 2 | %% icite -- Indices locorum citatorum |
3 | %% generated with the docstrip utility. | 3 | %% Copyright (C) 2016--2020 Robert Alesssi |
4 | %% | ||
5 | %% The original source files were: | ||
6 | %% | ||
7 | %% icite.dtx (with options: `install') | ||
8 | %% | 4 | %% |
9 | %% Copyright (C) 2019-2020 by Robert Alessi <alessi@robertalessi.net> | 5 | %% Copyright (C) 2019-2020 by Robert Alessi <alessi@robertalessi.net> |
10 | %% | 6 | %% |
@@ -35,6 +31,9 @@ | |||
35 | \askforoverwritefalse | 31 | \askforoverwritefalse |
36 | \preamble | 32 | \preamble |
37 | 33 | ||
34 | icite -- Indices locorum citatorum | ||
35 | Copyright (C) 2016--2020 Robert Alesssi | ||
36 | |||
38 | Copyright (C) 2019-2020 by Robert Alessi <alessi@robertalessi.net> | 37 | Copyright (C) 2019-2020 by Robert Alessi <alessi@robertalessi.net> |
39 | 38 | ||
40 | Please send error reports and suggestions for improvements to Robert | 39 | Please send error reports and suggestions for improvements to Robert |