Skip to content

Commit fdb5a30

Browse files
authored
Merge pull request #2 from gpontesss/update-readme-with-building-instructions
Add instructions on how to build the document
2 parents cd44618 + 909b5d2 commit fdb5a30

File tree

1 file changed

+27
-1
lines changed

1 file changed

+27
-1
lines changed

README.md

+27-1
Original file line numberDiff line numberDiff line change
@@ -1,4 +1,4 @@
1-
![adornation](img/headers/bar18.svg)
1+
![adornation](img/headers/bar20.svg)
22

33
# Russian Orthodox Prayer Book
44

@@ -12,6 +12,27 @@ Images were obtained from the [Orthodox Arts Journal] project. Since the
1212
repository's license allows for commercial usage, be aware that the [due credit
1313
should be given to the images](image-credit).
1414

15+
## Building the project locally
16+
17+
To build a project locally, the following dependencies are needed:
18+
19+
* [XeTeX]: TeX's extension used;
20+
* [Inkscape]: For rendering SVG into images compatible with TeX;
21+
* [Python]: For running the script which installs the required fonts;
22+
* [GNU Make]: For building the document.
23+
24+
To build the document:
25+
26+
```sh
27+
# Installs required fonts
28+
./scripts/install-font.sh "Gentium Book Plus" "EB Garamond"
29+
# Builds the document
30+
make
31+
```
32+
33+
If you have any doubts on minimal dependencies, take a look at the [build
34+
workflow] for an example of a setup from scratch.
35+
1536
## Acessing a release build
1637

1738
Every build is available as an attached asset called `prayer-book.pdf` in its
@@ -22,3 +43,8 @@ recent build.
2243
[Jordanville edition]: https://www.ponomar.net/data/jordanville_prayerbook.pdf
2344
[Orthodox Arts Journal]: https://orthodoxartsjournal.org/orthodox-illustration-project/
2445
[image-credit]: https://docs.google.com/file/d/0B1MLai552F5yZkJIQ3B0QWx3cDA/view?rm=minimal&resourcekey=0-ybOjgmmviTqQOikbXOc9ag
46+
[XeTeX]: https://tug.org/xetex/
47+
[Inkscape]: https://inkscape.org/
48+
[GNU Make]: https://www.gnu.org/software/make/
49+
[Python]: https://www.python.org/
50+
[build workflow]: .github/workflows/build.yml

0 commit comments

Comments
 (0)