Add Persian (Farsi) translation and Makefile update for BlackArch Guide

Makefile

@@ -191,9 +191,23 @@ lint-zh:
 		ba-guide:$(VERSION) \
 		/bin/sh -c "chktex ${srcdir}/*-zh.tex; exit 0"
 
+PHONY: lint-fa
+lint-fa:
+	@echo "==========================================="
+	@echo "= linting Persian Guide                   ="
+	@echo "==========================================="
+	@docker run \
+		--rm \
+		-ti \
+		-v $(shell pwd):/guide:rw \
+		-w /guide \
+		--hostname ba-guide \
+		ba-guide:$(VERSION) \
+		/bin/sh -c "chktex ${srcdir}/*-fa.tex; exit 0"
+
 # run the latex linting tool
 .PHONY: lint
-lint: lint-de lint-el lint-en lint-es lint-fr lint-it lint-pt-br lint-ru lint-tr lint-zh
+lint: lint-de lint-el lint-en lint-es lint-fa lint-fr lint-it lint-pt-br lint-ru lint-tr lint-zh
 
 # generate pdf per language
 .PHONY: pdf-de
@@ -256,6 +270,21 @@ pdf-es:
 			    lualatex \
 			    ${srcdir}/blackarch-guide-es.tex 1>>./build_log_es"
 
+.PHONY: pdf-fa
+pdf-fa:
+	@echo "Compiling Persian guide - output in build_log_fa"
+	@docker run \
+		--rm \
+		-ti \
+		-v $(shell pwd):/guide:rw \
+		-w /guide \
+		--hostname ba-guide \
+		ba-guide:$(VERSION) \
+		/bin/sh -c "lualatex \
+			    ${srcdir}/blackarch-guide-fa.tex 1>./build_log_fa; \
+			    lualatex \
+			    ${srcdir}/blackarch-guide-fa.tex 1>>./build_log_fa"
+
 .PHONY: pdf-fr
 pdf-fr:
 	@echo "Compiling French guide - output in build_log_fr"
@@ -363,4 +392,4 @@ pdf-zh:
 
 # generate for all languages
 .PHONY: pdf
-pdf: pdf-de pdf-el pdf-en pdf-es pdf-fr pdf-it pdf-pt-br pdf-ru pdf-tr pdf-zh
+pdf: pdf-de pdf-el pdf-en pdf-es pdf-fa pdf-fr pdf-it pdf-pt-br pdf-ru pdf-tr pdf-zh

README.md

@@ -3,41 +3,42 @@
 This is part of BlackArch Linux and provides the latex files for the BlackArch
 User Guides.
 
-To create a new Guide in in a language create a 
-blackarch-guide-<your-country-code>.tex and an appendex-<your-country-code>.tex
+To create a new Guide in in a language create a
+blackarch-guide-`<your-country-code>`.tex and an appendex-`<your-country-code>`.tex
 file in the latex directory and add the
-target to the ```Makefile```.
-
+target to the ``Makefile``.
 
 Everything is compiled in a Docker container, so the only dependency
 needed is docker.
 
--------
+---
 
 ### Build
-To compile the guides run 
-```make docker-build```
-```make pdf```
 
-This will compile all guides listed as targets in the ```Makefile```.
+To compile the guides run
+``make docker-build``
+``make pdf``
+
+This will compile all guides listed as targets in the ``Makefile``.
 
 ##### Current Targets are:
+
 * de
 * el
 * en
 * es
-* fr 
+* fa
+* fr
 * it
 * pt-br
 * ru
 * tr
 * zh
 
 You can also build a single guide (e.g. German)
-```make pdf-de```
+``make pdf-de``
 
 linting is done via
-``` make lint```
-or for a subtarget (e.g. English) 
-```make lint-en```
-
+`` make lint``
+or for a subtarget (e.g. English)
+``make lint-en``