summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorKarl Berry <karl@freefriends.org>2024-01-15 21:01:06 +0000
committerKarl Berry <karl@freefriends.org>2024-01-15 21:01:06 +0000
commit88d9bd889eeadb2db364e01ac526ee1b5eef0d2e (patch)
treecc8b68821e20d47c09fc01b252390c743aad8180
parent326b9ba341e07b15b6b764f3b3e3a22eb058e425 (diff)
amnestyreport (15jan24)
git-svn-id: svn://tug.org/texlive/trunk@69439 c570f23f-e606-0410-a88d-b1316a301751
-rw-r--r--Master/texmf-dist/doc/latex/amnestyreport/BoschFragment.pngbin0 -> 685950 bytes
-rw-r--r--Master/texmf-dist/doc/latex/amnestyreport/README17
-rw-r--r--Master/texmf-dist/doc/latex/amnestyreport/amnestyreport.pdfbin0 -> 153073 bytes
-rw-r--r--Master/texmf-dist/doc/latex/amnestyreport/amnestytemplate.tex70
-rw-r--r--Master/texmf-dist/doc/latex/amnestyreport/examplereferences.bib20
-rw-r--r--Master/texmf-dist/doc/latex/amnestyreport/sample.Rmd277
-rw-r--r--Master/texmf-dist/doc/latex/amnestyreport/sample.pdfbin0 -> 708637 bytes
-rw-r--r--Master/texmf-dist/doc/latex/amnestyreport/sample.tex400
-rw-r--r--Master/texmf-dist/source/latex/amnestyreport/Makefile68
-rw-r--r--Master/texmf-dist/source/latex/amnestyreport/amnestyreport.dtx1141
-rw-r--r--Master/texmf-dist/source/latex/amnestyreport/amnestyreport.ins29
-rw-r--r--Master/texmf-dist/tex/latex/amnestyreport/amnestyreport.cls435
-rwxr-xr-xMaster/tlpkg/bin/tlpkg-ctan-check2
-rw-r--r--Master/tlpkg/tlpsrc/amnestyreport.tlpsrc0
-rw-r--r--Master/tlpkg/tlpsrc/collection-publishers.tlpsrc1
15 files changed, 2459 insertions, 1 deletions
diff --git a/Master/texmf-dist/doc/latex/amnestyreport/BoschFragment.png b/Master/texmf-dist/doc/latex/amnestyreport/BoschFragment.png
new file mode 100644
index 00000000000..dad1c1fd6f9
--- /dev/null
+++ b/Master/texmf-dist/doc/latex/amnestyreport/BoschFragment.png
Binary files differ
diff --git a/Master/texmf-dist/doc/latex/amnestyreport/README b/Master/texmf-dist/doc/latex/amnestyreport/README
new file mode 100644
index 00000000000..e33ab10627e
--- /dev/null
+++ b/Master/texmf-dist/doc/latex/amnestyreport/README
@@ -0,0 +1,17 @@
+ LaTeX class for Amnesty International
+ Boris Veytsman
+
+This package provides the class for Amnesty International reports
+according to guidelines at https://brandhub.amnesty.org/
+
+License: LPPL 1.3
+
+Version 1.2: Added sideways captions. Rewrote documentation.
+ Made a distribution free version with free fonts and
+ no logo.
+
+Version 1.1: Added nologo option and quotations code
+
+Version 1.0: Added glossary and freefonts option
+
+Version 0.2: the first released version \ No newline at end of file
diff --git a/Master/texmf-dist/doc/latex/amnestyreport/amnestyreport.pdf b/Master/texmf-dist/doc/latex/amnestyreport/amnestyreport.pdf
new file mode 100644
index 00000000000..9564061baf6
--- /dev/null
+++ b/Master/texmf-dist/doc/latex/amnestyreport/amnestyreport.pdf
Binary files differ
diff --git a/Master/texmf-dist/doc/latex/amnestyreport/amnestytemplate.tex b/Master/texmf-dist/doc/latex/amnestyreport/amnestytemplate.tex
new file mode 100644
index 00000000000..f593e0ae6c9
--- /dev/null
+++ b/Master/texmf-dist/doc/latex/amnestyreport/amnestytemplate.tex
@@ -0,0 +1,70 @@
+\documentclass[
+$if(papersize)$
+ $papersize$paper,
+$endif$
+$for(classoption)$
+ $classoption$$sep$,
+$endfor$
+]{amnestyreport}
+$highlighting-macros$
+$for(header-includes)$
+$header-includes$
+$endfor$
+$if(title)$
+\title{$title$}
+$endif$
+$if(subtitle)$
+\subtitle{$subtitle$}
+$endif$
+$if(titleimage)$
+\titleimage{$titleimage$}
+$endif$
+$if(titleimagecaption)$
+\titleimagecaption{$titleimagecaption$}
+$endif$
+$if(copyrightyear)$
+\copyrightyear{$copyrightyear$}
+$endif$
+$if(firstpublicationyear)$
+\firstpublicationyear{$firstpublicationyear$}
+$endif$
+$if(reportyear)$
+\reportyear{$reportyear$}
+$endif$
+$if(reportmonth)$
+\reportmonth{$reportmonth$}
+$endif$
+$if(reportindex)$
+\reportindex{$reportindex$}
+$endif$
+$if(blurb)$
+\blurb{$blurb$}
+$endif$
+
+$if(bibliography)$
+\addbibresource{$bibliography$}
+$endif$
+
+\begin{document}
+\frontmatter
+\maketitle
+
+$for(include-before)$
+$include-before$
+$endfor$
+
+$if(toc)$
+\tableofcontents
+$endif$
+$if(lof)$
+\listoffigures
+$endif$
+$if(lot)$
+\listoftables
+$endif$
+\mainmatter
+
+$body$
+
+\backmatter
+\end{document} \ No newline at end of file
diff --git a/Master/texmf-dist/doc/latex/amnestyreport/examplereferences.bib b/Master/texmf-dist/doc/latex/amnestyreport/examplereferences.bib
new file mode 100644
index 00000000000..8c546e4793d
--- /dev/null
+++ b/Master/texmf-dist/doc/latex/amnestyreport/examplereferences.bib
@@ -0,0 +1,20 @@
+@Misc{FirstRef2023,
+ author = {{Some News Organization}},
+ month = {August},
+ title = {{Media article on some topic}},
+ year = {2023},
+ note = {AFR/23/45/37},
+ url = {https://someweb.url},
+}
+
+@Misc{SecondRef2022,
+ author = {{Amnesty International}},
+ month = {July},
+ title = {{Some previous Amnesty research report title}},
+ year = {2022},
+ note = {AFR/23/45/37},
+ url = {https://someother.url},
+}
+
+
+@Comment{jabref-meta: databaseType:bibtex;}
diff --git a/Master/texmf-dist/doc/latex/amnestyreport/sample.Rmd b/Master/texmf-dist/doc/latex/amnestyreport/sample.Rmd
new file mode 100644
index 00000000000..07de47664d4
--- /dev/null
+++ b/Master/texmf-dist/doc/latex/amnestyreport/sample.Rmd
@@ -0,0 +1,277 @@
+---
+title: "RMarkdown report example"
+subtitle: "An example report for Amnesty output"
+titleimage: "BoschFragment"
+titleimagecaption: "The Garden of Earthly Delights is the modern title
+given to a triptych oil painting on oak panel painted by the Early
+Netherlandish master Hieronymus Bosch, between 1490 and 1510, when
+Bosch was between 40 and 60 years old. It has been housed in the
+Museo del Prado in Madrid, Spain since 1939.\n\n
+\\textcopyright{} Image: Public domain.\n\n
+\\textcopyright{} Caption: Wikipedia contributors, 2023, released
+under Creative Commons Attribution-ShareAlike License 4.0"
+copyrightyear: 2023
+firstpublicationyear: 2022
+reportindex: ABXC/AAAA/2022
+blurb: "This sample output of Rmarkdown with TeX shows the general
+commands and options of the amnestyinternational TeX class. It is based
+on the text by Jule Krueger."
+
+output:
+ pdf_document:
+ template: amnestytemplate.tex
+ latex_engine: xelatex
+ toc: true
+ keep_tex: true
+ citation_package: natbib
+classoption: freefonts, nologo
+header-includes:
+ - \renewcommand{\thesection}{\Alph{section}}
+bibliography: "examplereferences.bib"
+vignette: >
+ %\VignetteIndexEntry{amenstyreportR}
+ %\VignetteEngine{knitr::rmarkdown}
+ %\VignetteEncoding{UTF-8}
+---
+```{r setup, include=FALSE}
+library(amnestyreportR)
+setup_amnesty_plots(options='freefonts, nologo')
+# use
+# setup_amnesty_plots(draft=TRUE)
+# to make fast draft plots
+library(knitr)
+library(tidyr)
+library(dplyr)
+library(ggplot2)
+```
+
+
+\begin{AmnestyGlossary}[10em]
+Commute &
+Commute means to replace a punishment, usually a death sentence, with a less severe one. For example, Amnesty called for the USA to commute to time served the 35-year jail sentence of whistleblower Chelsea Manning, who had been arrested after leaking classified government material
+\\
+Crimes against humanity &
+When certain acts---including murder, torture and slavery---form part of a widespread attack on a civilian population by a state or organization. Unlike war crimes, they can take place at times of peace as well as during conflict. The Rwandan genocide of 1994 is one example of a crime against humanity.
+\\
+Extrajudicial executions &
+Unlawful killings ordered by a government, or committed with its knowledge and support. They can be carried out by the military, police, or by civilians working with government forces. For example, Hamas forces in Gaza committed serious human rights abuses, including extrajudicial executions, torture and abductions, during the 2014 Gaza/Israel conflict.
+\\
+Freedom of expression &
+The right to seek, receive and share information and ideas, without fear or interference. It is closely linked with freedom of association (the right to meet with anyone you choose, for example, to form and join clubs, societies or trade unions) and the right to take part in a peaceful assembly, such as a demonstration or public meeting.
+\\
+Immunity (from prosecution) &
+Allows an accused person to avoid prosecution for a crime because of their job or office. Amnesty International is opposed to immunity. For example, Amnesty has called for the rejection of immunity in the Central African Republic so that people who committed crimes during conflict there are brought to justice.
+\\
+Impunity &
+Impunity is when people who have committed crimes avoid punishment. For example, there is a ‘culture of impunity’ among police in the Philippines, who are able to torture people without fear of being punished. Amnesty calls for these people to be tried and sentenced fairly, according to the law.
+\\
+Prisoner of conscience &
+A prisoner of conscience is someone who is imprisoned because of who they are (sexual orientation, ethnic, national or social origin, language, birth, colour, sex or economic status) or their religious, political or other beliefs, and who hasn’t used or advocated violence. For example, Dr Mohammed al-Roken is a current prisoner of conscience in the United Arab Emirates, jailed for 10 years following a deeply unfair trial.
+\\
+War crimes &
+War crimes are serious crimes committed during armed conflicts, which could include murdering prisoners of war, killing hostages, torture and destroying towns and villages. A recent example is in the Ukraine, where there is overwhelming evidence of ongoing war crimes, including torture and summary killings of prisoners.
+\\
+\end{AmnestyGlossary}
+
+From \url{https://www.amnesty.org/en/latest/campaigns/2015/07/beginners-guide-human-rights-jargon/}
+
+\clearpage
+# Introduction {.unnumbered}
+
+In this document we discuss the use of `amnestyreport.cls`, and accompanying `R` package \& `pandoc` template for writing Amnesty International Reports.
+
+You can either use an `Rnw` file with \LaTeX\ syntax, or an `Rmd` file with R Markdown syntax. In both cases you need:
+
+* The \LaTeX\ class file `amnestyreport.cls`,
+* A properly installed `R` package `amnestyreportR`,
+* Optionally Amnesty International fonts and logo (see below).
+
+If you use R Markdown syntax rather than \LaTeX\ syntax, you also need
+
+* The `pandoc` template `amnestytemplate.tex`
+
+## A note about the fonts and logos {.unnumbered}
+
+If you have an established relationship with Amnesty International, you may use their fonts and logos in your report. You need to install the fonts, and the file with the logo (rename it to `Amnesty_logo.png`). Otherwise you need the options `freefonts, nologo` in your preamble for \LaTeX\ or the line
+`classoption: freefonts, nologo` in the RMD preamble.
+
+## Rmd premable example {.unnumbered}
+
+If you use Rmd, you need to specify in your preamble that
+
+* You are using the template `amnestytemplate.tex` rather than the generic `pandoc` template;
+* You are using `xelatex` (or `lualatex`) rather than a 8-bit engine `podflatex`.
+
+For example this file has the following preamble:
+
+
+```
+---
+title: "RMarkdown report example"
+subtitle: "An example report for Amnesty output"
+titleimage: "BoschFragment"
+titleimagecaption: "The Garden of Earthly Delights is the modern title
+given to a triptych oil painting on oak panel painted by the Early
+Netherlandish master Hieronymus Bosch, between 1490 and 1510, when
+Bosch was between 40 and 60 years old. It has been housed in the
+Museo del Prado in Madrid, Spain since 1939.\n\n
+\\textcopyright{} Image: Public domain.\n\n
+\\textcopyright{} Caption: Wikipedia contributors, 2023, released
+under Creative Commons Attribution-ShareAlike License 4.0"
+copyrightyear: 2023
+firstpublicationyear: 2022
+reportindex: ABXC/AAAA/2022
+blurb: "This sample output of Rmarkdown with TeX shows the general
+commands and options of the amnestyinternational TeX class. It is based
+on the text by Jule Krueger."
+
+output:
+ pdf_document:
+ template: amnestytemplate.tex
+ latex_engine: xelatex
+ toc: true
+ keep_tex: true
+ citation_package: natbib
+classoption: freefonts, nologo
+header-includes:
+ - \renewcommand{\thesection}{\Alph{section}}
+bibliography: "examplereferences.bib"
+---
+```
+
+\clearpage
+
+# Cross-references and bibliography \label{cross-ref}
+
+You can use the standard \LaTeX\ and R Markdown facilities for references.
+
+The package uses `biblatex` with the `bibtex` backend for citations to provide footnote citations, [See @SecondRef2022]\textsuperscript{,}[See also @FirstRef2023, p.12] and [@FirstRef2023, p. 23]. However, due to idiosyncrasies of `pandoc` we need to specify `natbib` as the citation engine in the preamble. Never mind biblatex warnings during the processing.
+
+
+Below in \autoref{sec:figures_tables} we show the examples of tables and figures provided by the package.
+
+
+# Figures and tables \label{sec:figures_tables}
+
+## Inline expressions
+
+Irises are beautiful flowers that come in different types, shapes and sizes. In this report, we look at different species of irises in terms of petal size.\footnote{This is how you can add a footnote. Some footnotes are very long, and some are several lines log, but this is OK. Just make sure the indentation is right.}
+
+
+We define the variable `N_iris` and use it inline in the following example:
+
+```{r total_number_iris}
+N_iris <- nrow(iris)
+```
+
+There are a total of `r N_iris` (coded as \texttt{`}\texttt{r N\_iris}\texttt{`}) iris flower specimen in the built-in \textbf{iris} data.
+
+
+
+## A table
+
+Here is an example of a table using `kable` package and `amnesty_table` function:
+
+
+```{r example_table, eval=FALSE}
+iris %>%
+ count(Species) %>%
+ mutate(percent = n/sum(n)*100) %>%
+ bind_rows(summarise(., across(where(is.numeric), sum),
+ across(where(is.factor), ~'Total'))) %>%
+ amnesty_table(row.names = FALSE,
+ align = "lrr",
+ caption="\\label{tab:species}
+ Frequency distribution of iris species.",
+ position="!ht",
+ col.names = c("Species", "Number of species", "(%)"),
+ digits=2) %>%
+ kableExtra::row_spec(4, bold=TRUE)
+```
+
+We can typeset it with sideways caption using `\sideTableCaptions`:
+\sideTableCaptions
+
+```{r example_table, echo=FALSE, eval=TRUE}
+```
+
+Alternatively, we can typeset it with normal captions using `\normalTableCaptions`:
+\normalTableCaptions
+```{r example_table_1, echo=FALSE}
+iris %>%
+ count(Species) %>%
+ mutate(percent = n/sum(n)*100) %>%
+ bind_rows(summarise(., across(where(is.numeric), sum),
+ across(where(is.factor), ~'Total'))) %>%
+ amnesty_table(row.names = FALSE,
+ align = "lrr",
+ caption="\\label{tab:species1}
+ Frequency distribution of iris species.",
+ position="!ht",
+ col.names = c("Species", "Number of species", "(%)"),
+ digits=2) %>%
+ kableExtra::row_spec(4, bold=TRUE)
+```
+
+
+
+\FloatBarrier
+
+## Figures
+
+Normally the figures are prepared in separate \LaTeX\ runs. This might be very slow, so you may want to use the draft mode for the editing runs. Before making the figures, you need to issue the `R` command `setup_amnesty_plots(options=..., draft=...)`. The `options` are those that are passed to \LaTeX\ class; if you do not have Amnesty International fonts, use `freefonts`. The `draft` can be either `TRUE` or `FALSE` (for quick plots). For example
+
+```{r setup_example, eval=FALSE}
+setup_amnesty_plots() # You have Amnesty fonts and logo
+setup_amnesty_plots(options='freefonts, nologo') # No Amnesty fonts
+setup_amnesty_plots(draft=TRUE) # Draft mode
+```
+
+We are using the \textit{ggplot2} package to make an example figure from the built-in iris data. As can be seen in \autoref{fig:species-petal-size}, the virginica species of iris has the largest petal size in comparison to the other two iris species. Note that it is recommended to use both color and line shape to convey the same information for the benefit of color blind users.
+
+```{r species-petal-size, echo=FALSE, fig.cap="Distribution of petal length and petal width, by iris species.", fig.align="center", fig.height = 3, fig.width = 6}
+iris %>%
+ ggplot(aes(x=Petal.Length, y=Petal.Width, color=Species, fill=Species,
+ shape=Species)) +
+ geom_point() +
+ xlab("Petal Length") + ylab("Petal Width")
+```
+
+
+
+We use viridis scale optimized for color blind users both for the discrete (\autoref{fig:species-petal-size}) and continuous (\autoref{fig:petal-size-sepal-size}) scales. We also use `\sideFigureCaptions` to typeset the caption on the side
+\sideFigureCaptions
+
+```{r, petal-size-sepal-size, fig.cap="Distribution of petal and sepal sizes", fig.align="center", fig.height = 3, fig.width = 4, echo=FALSE}
+iris %>% ggplot + geom_point(aes(Petal.Length, Petal.Width, color=Sepal.Length)) +
+labs(x="Petal Length", y="Petal Width", colour="Sepal Length")
+```
+
+\clearpage
+
+# Other typographic features
+
+## A subsection heading
+
+### A subsubsection heading
+
+#### A subsubsubsection heading
+We have line break after a subsubsubsection heading as Amnesty style requires.
+
+#### Type of iris species (Species)
+This variable indicates the different botanical types of iris species.
+
+\begin{description}
+\item[\textbf{setosa:}] The iris belongs to the botanical species of setosa.
+\item[\textbf{versicolor:}] The iris belongs to the botanical species of versicolor.
+\item[\textbf{virginica:}] The iris belongs to the botanical species of virginica.
+\end{description}
+
+
+An example of a quotation.
+
+> All human beings are born free and equal in dignity and rights. They are endowed with reason and conscience and should act towards one another in a spirit of brotherhood.
+>
+> \attribution{Universal Declaration of Human Rights}
+
+
diff --git a/Master/texmf-dist/doc/latex/amnestyreport/sample.pdf b/Master/texmf-dist/doc/latex/amnestyreport/sample.pdf
new file mode 100644
index 00000000000..4f4520bfa8d
--- /dev/null
+++ b/Master/texmf-dist/doc/latex/amnestyreport/sample.pdf
Binary files differ
diff --git a/Master/texmf-dist/doc/latex/amnestyreport/sample.tex b/Master/texmf-dist/doc/latex/amnestyreport/sample.tex
new file mode 100644
index 00000000000..a72d70fd8e8
--- /dev/null
+++ b/Master/texmf-dist/doc/latex/amnestyreport/sample.tex
@@ -0,0 +1,400 @@
+\documentclass[
+ freefonts, nologo]{amnestyreport}
+\usepackage{color}
+\usepackage{fancyvrb}
+\newcommand{\VerbBar}{|}
+\newcommand{\VERB}{\Verb[commandchars=\\\{\}]}
+\DefineVerbatimEnvironment{Highlighting}{Verbatim}{commandchars=\\\{\}}
+% Add ',fontsize=\small' for more characters per line
+\usepackage{framed}
+\definecolor{shadecolor}{RGB}{248,248,248}
+\newenvironment{Shaded}{\begin{snugshade}}{\end{snugshade}}
+\newcommand{\AlertTok}[1]{\textcolor[rgb]{0.94,0.16,0.16}{#1}}
+\newcommand{\AnnotationTok}[1]{\textcolor[rgb]{0.56,0.35,0.01}{\textbf{\textit{#1}}}}
+\newcommand{\AttributeTok}[1]{\textcolor[rgb]{0.13,0.29,0.53}{#1}}
+\newcommand{\BaseNTok}[1]{\textcolor[rgb]{0.00,0.00,0.81}{#1}}
+\newcommand{\BuiltInTok}[1]{#1}
+\newcommand{\CharTok}[1]{\textcolor[rgb]{0.31,0.60,0.02}{#1}}
+\newcommand{\CommentTok}[1]{\textcolor[rgb]{0.56,0.35,0.01}{\textit{#1}}}
+\newcommand{\CommentVarTok}[1]{\textcolor[rgb]{0.56,0.35,0.01}{\textbf{\textit{#1}}}}
+\newcommand{\ConstantTok}[1]{\textcolor[rgb]{0.56,0.35,0.01}{#1}}
+\newcommand{\ControlFlowTok}[1]{\textcolor[rgb]{0.13,0.29,0.53}{\textbf{#1}}}
+\newcommand{\DataTypeTok}[1]{\textcolor[rgb]{0.13,0.29,0.53}{#1}}
+\newcommand{\DecValTok}[1]{\textcolor[rgb]{0.00,0.00,0.81}{#1}}
+\newcommand{\DocumentationTok}[1]{\textcolor[rgb]{0.56,0.35,0.01}{\textbf{\textit{#1}}}}
+\newcommand{\ErrorTok}[1]{\textcolor[rgb]{0.64,0.00,0.00}{\textbf{#1}}}
+\newcommand{\ExtensionTok}[1]{#1}
+\newcommand{\FloatTok}[1]{\textcolor[rgb]{0.00,0.00,0.81}{#1}}
+\newcommand{\FunctionTok}[1]{\textcolor[rgb]{0.13,0.29,0.53}{\textbf{#1}}}
+\newcommand{\ImportTok}[1]{#1}
+\newcommand{\InformationTok}[1]{\textcolor[rgb]{0.56,0.35,0.01}{\textbf{\textit{#1}}}}
+\newcommand{\KeywordTok}[1]{\textcolor[rgb]{0.13,0.29,0.53}{\textbf{#1}}}
+\newcommand{\NormalTok}[1]{#1}
+\newcommand{\OperatorTok}[1]{\textcolor[rgb]{0.81,0.36,0.00}{\textbf{#1}}}
+\newcommand{\OtherTok}[1]{\textcolor[rgb]{0.56,0.35,0.01}{#1}}
+\newcommand{\PreprocessorTok}[1]{\textcolor[rgb]{0.56,0.35,0.01}{\textit{#1}}}
+\newcommand{\RegionMarkerTok}[1]{#1}
+\newcommand{\SpecialCharTok}[1]{\textcolor[rgb]{0.81,0.36,0.00}{\textbf{#1}}}
+\newcommand{\SpecialStringTok}[1]{\textcolor[rgb]{0.31,0.60,0.02}{#1}}
+\newcommand{\StringTok}[1]{\textcolor[rgb]{0.31,0.60,0.02}{#1}}
+\newcommand{\VariableTok}[1]{\textcolor[rgb]{0.00,0.00,0.00}{#1}}
+\newcommand{\VerbatimStringTok}[1]{\textcolor[rgb]{0.31,0.60,0.02}{#1}}
+\newcommand{\WarningTok}[1]{\textcolor[rgb]{0.56,0.35,0.01}{\textbf{\textit{#1}}}}
+\renewcommand{\thesection}{\Alph{section}}
+\usepackage{booktabs}
+\usepackage{longtable}
+\usepackage{array}
+\usepackage{multirow}
+\usepackage{wrapfig}
+\usepackage{float}
+\usepackage{colortbl}
+\usepackage{pdflscape}
+\usepackage{tabu}
+\usepackage{threeparttable}
+\usepackage{threeparttablex}
+\usepackage[normalem]{ulem}
+\usepackage{makecell}
+\usepackage{xcolor}
+\title{RMarkdown report example}
+\subtitle{An example report for Amnesty output}
+\titleimage{BoschFragment}
+\titleimagecaption{The Garden of Earthly Delights is the modern title
+given to a triptych oil painting on oak panel painted by the Early
+Netherlandish master Hieronymus Bosch, between 1490 and 1510, when Bosch
+was between 40 and 60 years old. It has been housed in the Museo del
+Prado in Madrid, Spain since 1939.\\
+\textcopyright{} Image: Public domain.\\
+\textcopyright{} Caption: Wikipedia contributors, 2023, released under
+Creative Commons Attribution-ShareAlike License 4.0}
+\copyrightyear{2023}
+\firstpublicationyear{2022}
+\reportindex{ABXC/AAAA/2022}
+\blurb{This sample output of Rmarkdown with TeX shows the general
+commands and options of the amnestyinternational TeX class. It is based
+on the text by Jule Krueger.}
+
+\addbibresource{examplereferences.bib}
+
+\begin{document}
+\frontmatter
+\maketitle
+
+
+\tableofcontents
+\mainmatter
+
+\begin{AmnestyGlossary}[10em]
+Commute &
+Commute means to replace a punishment, usually a death sentence, with a less severe one. For example, Amnesty called for the USA to commute to time served the 35-year jail sentence of whistleblower Chelsea Manning, who had been arrested after leaking classified government material
+\\
+Crimes against humanity &
+When certain acts---including murder, torture and slavery---form part of a widespread attack on a civilian population by a state or organization. Unlike war crimes, they can take place at times of peace as well as during conflict. The Rwandan genocide of 1994 is one example of a crime against humanity.
+\\
+Extrajudicial executions &
+Unlawful killings ordered by a government, or committed with its knowledge and support. They can be carried out by the military, police, or by civilians working with government forces. For example, Hamas forces in Gaza committed serious human rights abuses, including extrajudicial executions, torture and abductions, during the 2014 Gaza/Israel conflict.
+\\
+Freedom of expression &
+The right to seek, receive and share information and ideas, without fear or interference. It is closely linked with freedom of association (the right to meet with anyone you choose, for example, to form and join clubs, societies or trade unions) and the right to take part in a peaceful assembly, such as a demonstration or public meeting.
+\\
+Immunity (from prosecution) &
+Allows an accused person to avoid prosecution for a crime because of their job or office. Amnesty International is opposed to immunity. For example, Amnesty has called for the rejection of immunity in the Central African Republic so that people who committed crimes during conflict there are brought to justice.
+\\
+Impunity &
+Impunity is when people who have committed crimes avoid punishment. For example, there is a ‘culture of impunity’ among police in the Philippines, who are able to torture people without fear of being punished. Amnesty calls for these people to be tried and sentenced fairly, according to the law.
+\\
+Prisoner of conscience &
+A prisoner of conscience is someone who is imprisoned because of who they are (sexual orientation, ethnic, national or social origin, language, birth, colour, sex or economic status) or their religious, political or other beliefs, and who hasn’t used or advocated violence. For example, Dr Mohammed al-Roken is a current prisoner of conscience in the United Arab Emirates, jailed for 10 years following a deeply unfair trial.
+\\
+War crimes &
+War crimes are serious crimes committed during armed conflicts, which could include murdering prisoners of war, killing hostages, torture and destroying towns and villages. A recent example is in the Ukraine, where there is overwhelming evidence of ongoing war crimes, including torture and summary killings of prisoners.
+\\
+\end{AmnestyGlossary}
+
+From
+\url{https://www.amnesty.org/en/latest/campaigns/2015/07/beginners-guide-human-rights-jargon/}
+
+\clearpage
+
+\section*{Introduction}\label{introduction}
+\addcontentsline{toc}{section}{Introduction}
+
+In this document we discuss the use of \texttt{amnestyreport.cls}, and
+accompanying \texttt{R} package \& \texttt{pandoc} template for writing
+Amnesty International Reports.
+
+You can either use an \texttt{Rnw} file with \LaTeX~syntax, or an
+\texttt{Rmd} file with R Markdown syntax. In both cases you need:
+
+\begin{itemize}
+\tightlist
+\item
+ The \LaTeX~class file \texttt{amnestyreport.cls},
+\item
+ A properly installed \texttt{R} package \texttt{amnestyreportR},
+\item
+ Optionally Amnesty International fonts and logo (see below).
+\end{itemize}
+
+If you use R Markdown syntax rather than \LaTeX~syntax, you also need
+
+\begin{itemize}
+\tightlist
+\item
+ The \texttt{pandoc} template \texttt{amnestytemplate.tex}
+\end{itemize}
+
+\subsection*{A note about the fonts and
+logos}\label{a-note-about-the-fonts-and-logos}
+\addcontentsline{toc}{subsection}{A note about the fonts and logos}
+
+If you have an established relationship with Amnesty International, you
+may use their fonts and logos in your report. You need to install the
+fonts, and the file with the logo (rename it to
+\texttt{Amnesty\_logo.png}). Otherwise you need the options
+\texttt{freefonts,\ nologo} in your preamble for \LaTeX~or the line
+\texttt{classoption:\ freefonts,\ nologo} in the RMD preamble.
+
+\subsection*{Rmd premable example}\label{rmd-premable-example}
+\addcontentsline{toc}{subsection}{Rmd premable example}
+
+If you use Rmd, you need to specify in your preamble that
+
+\begin{itemize}
+\tightlist
+\item
+ You are using the template \texttt{amnestytemplate.tex} rather than
+ the generic \texttt{pandoc} template;
+\item
+ You are using \texttt{xelatex} (or \texttt{lualatex}) rather than a
+ 8-bit engine \texttt{podflatex}.
+\end{itemize}
+
+For example this file has the following preamble:
+
+\begin{verbatim}
+---
+title: "RMarkdown report example"
+subtitle: "An example report for Amnesty output"
+titleimage: "BoschFragment"
+titleimagecaption: "The Garden of Earthly Delights is the modern title
+given to a triptych oil painting on oak panel painted by the Early
+Netherlandish master Hieronymus Bosch, between 1490 and 1510, when
+Bosch was between 40 and 60 years old. It has been housed in the
+Museo del Prado in Madrid, Spain since 1939.\n\n
+\\textcopyright{} Image: Public domain.\n\n
+\\textcopyright{} Caption: Wikipedia contributors, 2023, released
+under Creative Commons Attribution-ShareAlike License 4.0"
+copyrightyear: 2023
+firstpublicationyear: 2022
+reportindex: ABXC/AAAA/2022
+blurb: "This sample output of Rmarkdown with TeX shows the general
+commands and options of the amnestyinternational TeX class. It is based
+on the text by Jule Krueger."
+
+output:
+ pdf_document:
+ template: amnestytemplate.tex
+ latex_engine: xelatex
+ toc: true
+ keep_tex: true
+ citation_package: natbib
+classoption: freefonts, nologo
+header-includes:
+ - \renewcommand{\thesection}{\Alph{section}}
+bibliography: "examplereferences.bib"
+---
+\end{verbatim}
+
+\clearpage
+
+\section{\texorpdfstring{Cross-references and bibliography
+\label{cross-ref}}{Cross-references and bibliography }}\label{cross-references-and-bibliography}
+
+You can use the standard \LaTeX~and R Markdown facilities for
+references.
+
+The package uses \texttt{biblatex} with the \texttt{bibtex} backend for
+citations to provide footnote citations,
+\citep[See][]{SecondRef2022}\textsuperscript{,}\citep[See
+also][12]{FirstRef2023} and \citep[23]{FirstRef2023}. However, due to
+idiosyncrasies of \texttt{pandoc} we need to specify \texttt{natbib} as
+the citation engine in the preamble. Never mind biblatex warnings during
+the processing.
+
+Below in \autoref{sec:figures_tables} we show the examples of tables and
+figures provided by the package.
+
+\section{\texorpdfstring{Figures and tables
+\label{sec:figures_tables}}{Figures and tables }}\label{figures-and-tables}
+
+\subsection{Inline expressions}\label{inline-expressions}
+
+Irises are beautiful flowers that come in different types, shapes and
+sizes. In this report, we look at different species of irises in terms
+of petal
+size.\footnote{This is how you can add a footnote. Some footnotes are very long, and some are several lines log, but this is OK. Just make sure the indentation is right.}
+
+We define the variable \texttt{N\_iris} and use it inline in the
+following example:
+
+\begin{Shaded}
+\begin{Highlighting}[]
+\NormalTok{N\_iris }\OtherTok{\textless{}{-}} \FunctionTok{nrow}\NormalTok{(iris)}
+\end{Highlighting}
+\end{Shaded}
+
+There are a total of 150 (coded as
+\texttt{`}\texttt{r N\_iris}\texttt{`}) iris flower specimen in the
+built-in \textbf{iris} data.
+
+\subsection{A table}\label{a-table}
+
+Here is an example of a table using \texttt{kable} package and
+\texttt{amnesty\_table} function:
+
+\begin{Shaded}
+\begin{Highlighting}[]
+\NormalTok{iris }\SpecialCharTok{\%\textgreater{}\%}
+ \FunctionTok{count}\NormalTok{(Species) }\SpecialCharTok{\%\textgreater{}\%}
+ \FunctionTok{mutate}\NormalTok{(}\AttributeTok{percent =}\NormalTok{ n}\SpecialCharTok{/}\FunctionTok{sum}\NormalTok{(n)}\SpecialCharTok{*}\DecValTok{100}\NormalTok{) }\SpecialCharTok{\%\textgreater{}\%}
+ \FunctionTok{bind\_rows}\NormalTok{(}\FunctionTok{summarise}\NormalTok{(., }\FunctionTok{across}\NormalTok{(}\FunctionTok{where}\NormalTok{(is.numeric), sum),}
+ \FunctionTok{across}\NormalTok{(}\FunctionTok{where}\NormalTok{(is.factor), }\SpecialCharTok{\textasciitilde{}}\StringTok{\textquotesingle{}Total\textquotesingle{}}\NormalTok{))) }\SpecialCharTok{\%\textgreater{}\%}
+ \FunctionTok{amnesty\_table}\NormalTok{(}\AttributeTok{row.names =} \ConstantTok{FALSE}\NormalTok{,}
+ \AttributeTok{align =} \StringTok{"lrr"}\NormalTok{,}
+ \AttributeTok{caption=}\StringTok{"}\SpecialCharTok{\textbackslash{}\textbackslash{}}\StringTok{label\{tab:species\}}
+\StringTok{ Frequency distribution of iris species."}\NormalTok{,}
+ \AttributeTok{position=}\StringTok{"!ht"}\NormalTok{,}
+ \AttributeTok{col.names =} \FunctionTok{c}\NormalTok{(}\StringTok{"Species"}\NormalTok{, }\StringTok{"Number of species"}\NormalTok{, }\StringTok{"(\%)"}\NormalTok{),}
+ \AttributeTok{digits=}\DecValTok{2}\NormalTok{) }\SpecialCharTok{\%\textgreater{}\%}
+\NormalTok{ kableExtra}\SpecialCharTok{::}\FunctionTok{row\_spec}\NormalTok{(}\DecValTok{4}\NormalTok{, }\AttributeTok{bold=}\ConstantTok{TRUE}\NormalTok{)}
+\end{Highlighting}
+\end{Shaded}
+
+We can typeset it with sideways caption using
+\texttt{\textbackslash{}sideTableCaptions}: \sideTableCaptions
+
+\begin{table}[!ht]
+
+\caption{\label{tab:example_table}\label{tab:species}
+ Frequency distribution of iris species.}
+\centering
+\begin{tabular}[t]{lrr}
+\toprule
+\textbf{Species} & \textbf{Number of species} & \textbf{(\%)}\\
+\midrule
+setosa & 50 & 33.33\\
+versicolor & 50 & 33.33\\
+virginica & 50 & 33.33\\
+\textbf{Total} & \textbf{150} & \textbf{100.00}\\
+\bottomrule
+\end{tabular}
+\end{table}
+
+Alternatively, we can typeset it with normal captions using
+\texttt{\textbackslash{}normalTableCaptions}: \normalTableCaptions
+
+\begin{table}[!ht]
+
+\caption{\label{tab:example_table_1}\label{tab:species1}
+ Frequency distribution of iris species.}
+\centering
+\begin{tabular}[t]{lrr}
+\toprule
+\textbf{Species} & \textbf{Number of species} & \textbf{(\%)}\\
+\midrule
+setosa & 50 & 33.33\\
+versicolor & 50 & 33.33\\
+virginica & 50 & 33.33\\
+\textbf{Total} & \textbf{150} & \textbf{100.00}\\
+\bottomrule
+\end{tabular}
+\end{table}
+
+\FloatBarrier
+
+\subsection{Figures}\label{figures}
+
+Normally the figures are prepared in separate \LaTeX~runs. This might be
+very slow, so you may want to use the draft mode for the editing runs.
+Before making the figures, you need to issue the \texttt{R} command
+\texttt{setup\_amnesty\_plots(options=...,\ draft=...)}. The
+\texttt{options} are those that are passed to \LaTeX~class; if you do
+not have Amnesty International fonts, use \texttt{freefonts}. The
+\texttt{draft} can be either \texttt{TRUE} or \texttt{FALSE} (for quick
+plots). For example
+
+\begin{Shaded}
+\begin{Highlighting}[]
+\FunctionTok{setup\_amnesty\_plots}\NormalTok{() }\CommentTok{\# You have Amnesty fonts and logo}
+\FunctionTok{setup\_amnesty\_plots}\NormalTok{(}\AttributeTok{options=}\StringTok{\textquotesingle{}freefonts, nologo\textquotesingle{}}\NormalTok{) }\CommentTok{\# No Amnesty fonts}
+\FunctionTok{setup\_amnesty\_plots}\NormalTok{(}\AttributeTok{draft=}\ConstantTok{TRUE}\NormalTok{) }\CommentTok{\# Draft mode}
+\end{Highlighting}
+\end{Shaded}
+
+We are using the \textit{ggplot2} package to make an example figure from
+the built-in iris data. As can be seen in
+\autoref{fig:species-petal-size}, the virginica species of iris has the
+largest petal size in comparison to the other two iris species. Note
+that it is recommended to use both color and line shape to convey the
+same information for the benefit of color blind users.
+
+\begin{figure}
+
+{\centering \includegraphics{sample_files/figure-latex/species-petal-size-1}
+
+}
+
+\caption{Distribution of petal length and petal width, by iris species.}\label{fig:species-petal-size}
+\end{figure}
+
+We use viridis scale optimized for color blind users both for the
+discrete (\autoref{fig:species-petal-size}) and continuous
+(\autoref{fig:petal-size-sepal-size}) scales. We also use
+\texttt{\textbackslash{}sideFigureCaptions} to typeset the caption on
+the side \sideFigureCaptions
+
+\begin{figure}
+
+{\centering \includegraphics{sample_files/figure-latex/petal-size-sepal-size-1}
+
+}
+
+\caption{Distribution of petal and sepal sizes}\label{fig:petal-size-sepal-size}
+\end{figure}
+
+\clearpage
+
+\section{Other typographic features}\label{other-typographic-features}
+
+\subsection{A subsection heading}\label{a-subsection-heading}
+
+\subsubsection{A subsubsection heading}\label{a-subsubsection-heading}
+
+\paragraph{A subsubsubsection heading}\label{a-subsubsubsection-heading}
+
+We have line break after a subsubsubsection heading as Amnesty style
+requires.
+
+\paragraph{Type of iris species
+(Species)}\label{type-of-iris-species-species}
+
+This variable indicates the different botanical types of iris species.
+
+\begin{description}
+\item[\textbf{setosa:}] The iris belongs to the botanical species of setosa.
+\item[\textbf{versicolor:}] The iris belongs to the botanical species of versicolor.
+\item[\textbf{virginica:}] The iris belongs to the botanical species of virginica.
+\end{description}
+
+An example of a quotation.
+
+\begin{quote}
+All human beings are born free and equal in dignity and rights. They are
+endowed with reason and conscience and should act towards one another in
+a spirit of brotherhood.
+
+\attribution{Universal Declaration of Human Rights}
+\end{quote}
+
+\backmatter
+\end{document} \ No newline at end of file
diff --git a/Master/texmf-dist/source/latex/amnestyreport/Makefile b/Master/texmf-dist/source/latex/amnestyreport/Makefile
new file mode 100644
index 00000000000..6d2c10c66f0
--- /dev/null
+++ b/Master/texmf-dist/source/latex/amnestyreport/Makefile
@@ -0,0 +1,68 @@
+PACKAGE=amnestyreport
+
+SAMPLES = \
+ sample.Rmd
+
+PDF = $(PACKAGE).pdf ${SAMPLES:%.Rmd=%.pdf}
+
+all: ${PDF}
+
+
+
+%.pdf: %.dtx $(PACKAGE).cls
+ xelatex $<
+ - bibtex $*
+ xelatex $<
+ - makeindex -s gind.ist -o $*.ind $*.idx
+ - makeindex -s gglo.ist -o $*.gls $*.glo
+ xelatex $<
+ while ( grep -q '^LaTeX Warning: Label(s) may have changed' $*.log) \
+ do xelatex $<; done
+
+%.pdf: %.Rmd $(PACKAGE).cls amnestytemplate.tex
+ Rscript -e "rmarkdown::render('$<', output_file='$@', output_format='pdf_document')"
+
+%.cls: %.ins %.dtx
+ xelatex $<
+
+%.pdf: %.tex $(PACKAGE).cls
+ xelatex $<
+ - bibtex $*
+ xelatex $<
+ while ( grep -q '^LaTeX Warning: Label(s) may have changed' $*.log) \
+ do xelatex $<; done
+
+.PRECIOUS: $(PACKAGE).cfg $(PACKAGE).cls
+
+
+clean:
+ $(RM) $(PACKAGE).cls *.log *.aux \
+ *.cfg *.glo *.idx *.toc \
+ *.ilg *.ind *.out *.lof \
+ *.lot *.bbl *.blg *.gls \
+ *.dvi *.ps *.thm *.tgz *.zip *.rpi \
+ *.hd sample-blx.bib sample.run.xml \
+ sample-tikzDictionary \
+ *-blx.bib
+ $(RM) -r sample_files
+
+distclean: clean
+ $(RM) $(PDF) sample.tex
+ $(RM) -r sample_files
+
+#
+# Archive for the distribution. Includes typeset documentation
+#
+archive: all clean
+ COPYFILE_DISABLE=1 \
+ tar -C .. -czvf ../$(PACKAGE).tgz --exclude '*~' \
+ --exclude '*.tgz' --exclude '*.zip' --exclude ".git*" \
+ --exclude Amnesty_logo.png $(PACKAGE)
+
+zip: all clean
+ make $(PACKAGE).cls
+ $(RM) $(PACKAGE).log
+ cd ..;\
+ zip -r $(PACKAGE).zip $(PACKAGE) -x "*.ins" -x "*.gitignore" \
+ -x "*-blx.bib" -x "*sample-tikzDictionary" -x "*sample_files*"
+
diff --git a/Master/texmf-dist/source/latex/amnestyreport/amnestyreport.dtx b/Master/texmf-dist/source/latex/amnestyreport/amnestyreport.dtx
new file mode 100644
index 00000000000..3c97bb2f8b5
--- /dev/null
+++ b/Master/texmf-dist/source/latex/amnestyreport/amnestyreport.dtx
@@ -0,0 +1,1141 @@
+% \iffalse
+%
+% Copyright 2023, Boris Veytsman
+% This work may be distributed and/or modified under the
+% conditions of the LaTeX Project Public License, either
+% version 1.3 of this license or (at your option) any
+% later version.
+% The latest version of the license is in
+% http://www.latex-project.org/lppl.txt
+% and version 1.3 or later is part of all distributions of
+% LaTeX version 2005/12/01 or later.
+%
+% This work has the LPPL maintenance status `maintained'.
+%
+% The Current Maintainer of this work is Boris Veytsman,
+% <borisv@lk.net>
+%
+% This work consists of the file amnestyreport.dtx and the
+% derived file amnestyreport.cls.
+%
+%
+%
+% \fi
+% \CheckSum{0}
+%
+%
+%% \CharacterTable
+%% {Upper-case \A\B\C\D\E\F\G\H\I\J\K\L\M\N\O\P\Q\R\S\T\U\V\W\X\Y\Z
+%% Lower-case \a\b\c\d\e\f\g\h\i\j\k\l\m\n\o\p\q\r\s\t\u\v\w\x\y\z
+%% Digits \0\1\2\3\4\5\6\7\8\9
+%% Exclamation \! Double quote \" Hash (number) \#
+%% Dollar \$ Percent \% Ampersand \&
+%% Acute accent \' Left paren \( Right paren \)
+%% Asterisk \* Plus \+ Comma \,
+%% Minus \- Point \. Solidus \/
+%% Colon \: Semicolon \; Less than \<
+%% Equals \= Greater than \> Question mark \?
+%% Commercial at \@ Left bracket \[ Backslash \\
+%% Right bracket \] Circumflex \^ Underscore \_
+%% Grave accent \` Left brace \{ Vertical bar \|
+%% Right brace \} Tilde \~}
+%
+%\iffalse
+% Taken from xkeyval.dtx
+%\fi
+%\makeatletter
+%\def\DescribeOption#1{\leavevmode\@bsphack
+% \marginpar{\raggedleft\PrintDescribeOption{#1}}%
+% \SpecialOptionIndex{#1}\@esphack\ignorespaces}
+%\def\PrintDescribeOption#1{\strut\emph{option}\\\MacroFont #1\ }
+%\def\SpecialOptionIndex#1{\@bsphack
+% \index{#1\actualchar{\protect\ttfamily#1}
+% (option)\encapchar usage}%
+% \index{options:\levelchar#1\actualchar{\protect\ttfamily#1}\encapchar
+% usage}\@esphack}
+%\def\DescribeOptions#1{\leavevmode\@bsphack
+% \marginpar{\raggedleft\strut\emph{options}%
+% \@for\@tempa:=#1\do{%
+% \\\strut\MacroFont\@tempa\SpecialOptionIndex\@tempa
+% }}\@esphack\ignorespaces}
+%\makeatother
+%
+% \MakeShortVerb{|}
+% \GetFileInfo{amnestyreport.dtx}
+% % \changes{v1.1}{2023/12/31}{Documentation update}
+% \newcommand{\progname}[1]{\textsf{#1}}
+% \title{\LaTeX{} Class for \emph{Amnesty International}
+% Reports\thanks{\copyright 2023, Boris Veytsman}}
+% \author{Boris Veytsman\thanks{%
+% \href{mailto:borisv@lk.net}{\texttt{borisv@lk.net}},
+% \href{mailto:boris@varphi.com}{\texttt{boris@varphi.com}}}}
+% \date{\filedate, \fileversion}
+% \maketitle
+% \begin{abstract}
+% This package provides a class for typesetting Reports for
+% \emph{Amnesty International}
+% \end{abstract}
+% \tableofcontents
+%
+% \clearpage
+% \section{Introduction}
+% \label{sec:intro}
+%
+% \emph{Amnesty International} house style is describes in the Amnesty
+% International brand hub, \url{https://brandhub.amnesty.org}. Most
+% reports for \emph{Amnesty International} were made using word
+% processing software or typesetting software like \emph{InDesign}.
+% The onset of reports made with \TeX, or \textsl{R} using
+% \textsl{knitr} or \textsl{Rmarkdown} made necessary to recreate the
+% house style in \TeX. This file provides such style.
+%
+% I am grateful to Richard Swingler and Jule Krueger for their testing
+% and helpful comments.
+%
+% To use the style, you need the files |amnestyreport.cls|, the fonts
+% and the logos. They can be downloaded from
+% \url{https://brandhub.amnesty.org/} (note that you need to have a
+% special permission to use the font). You need to rename the file
+% with the logo into |Amnesty_logo.png|.
+%
+% To use the style just say
+% \begin{quote}
+% |\usepackage|\oarg{options}|{amnestyreports}|
+% \end{quote}
+%
+%
+% The option |amnestyfonts| (the default) selects the font Amnesty
+% Trade Gothic
+% (\url{https://brandhub.amnesty.org/visual-design/our-typeface/}) for
+% the report. The researchers working with Amnesty International may
+% download this font. If you are a student of work on a
+% self-initiated project, use the option |freefonts| to use free fonts
+% similar to Amnesty Trade Gothic.
+%
+% The option |nologo| suppresses the use of Amnesty International
+% logo. It is automatically chosen if \LaTeX\ cannot find the file
+% |Amnesty_logo.png| in the search path.
+%
+% The paper size options currently supported are |letterpaper| and
+% |a4paper| (the later is the default).
+%
+%
+%
+%\subsection{Use of the styles with Rmarkdown}
+%\label{sec:Rmarkdown}
+%
+% If you use the style with the \emph{Rmarkdown} package, you need to
+% include the file \path{amnestytemplate.tex}, which accompanies this
+% release. The YAML syntax for the commands is easy to get from the
+% the example \path{sample.Rmd}:
+% \begin{verbatim}
+% ---
+% title: "RMarkdown report example"
+% subtitle: "An example report for Amnesty output"
+% titleimage: "BoschFragment"
+% titleimagecaption: "The Garden of Earthly Delights is the modern title
+% given to a triptych oil painting on oak panel painted by the Early
+% Netherlandish master Hieronymus Bosch, between 1490 and 1510, when
+% Bosch was between 40 and 60 years old. It has been housed in the
+% Museo del Prado in Madrid, Spain since 1939.\n\n
+% \\textcopyright{} Image: Public domain.\n\n
+% \\textcopyright{} Caption: Wikipedia contributors, 2023, released
+% under Creative Commons Attribution-ShareAlike License 4.0"
+% copyrightyear: 2023
+% firstpublicationyear: 2022
+% reportindex: ABXC/AAAA/2022
+%
+% output:
+% pdf_document:
+% template: amnestytemplate.tex
+% latex_engine: xelatex
+% toc: true
+% keep_tex: true
+% citation_package: natbib
+% header-includes:
+% - \renewcommand{\thesection}{\Alph{section}}
+% bibliography: "examplereferences.bib"
+% ---
+%
+% \end{verbatim}
+%
+% Some notes:
+% \begin{enumerate}
+% \item The file names for bibliography and title images should not
+% include underscores or spaces.
+% \item In multiline strings use |\n\n| for paragraph breaks and two
+% backslashes
+% for \TeX\ commands.
+% \end{enumerate}
+%
+% There is an accompanying R package \textsl{amnestyreportR}. It
+% helps to create plots and tables in the style of Amnesty Report.
+% See the sample file for an example of use. You may download the
+% package from the Amnesty International site or CRAN.
+%
+%
+%\subsection{Front matter}
+%\label{sec:ug_frontmatter}
+%
+% \DescribeMacro{\maketitle}%
+% Front matter is the part of the report that includes title, half
+% title (the back of the title page), table of contents, glossary,
+% foreword, etc. Some of it is typeset automatically by the command
+% \cs{maketitle}, which must be preceded by a number of commands that
+% set the information to be typeset.
+%
+% \DescribeMacro{\titleimage}%
+% \DescribeMacro{\titleimagecaption}%
+% The command \cs{titleimage}\marg{filename} defines the image on the
+% title page. This file must be square. It will be resized
+% automatically to the standard size
+% $\qty{18.17}{\centi\meter}\times\qty{18.17}{\centi\meter}$. The
+% command \cs{titleimagecaption}\marg{caption} describes the image.
+% It should have copyright information; you may use the command
+% \cs{textcopyright} for the copyright symbol.
+%
+% \DescribeMacro{\title}%
+% \DescribeMacro{\subtitle}%
+% The command \cs{title} is similar to the one in standard classes. An
+% additional command \cs{subtitle} is used to set the subtitle of the
+% report.
+%
+% \DescribeMacro{\copyrightyear}%
+% \DescribeMacro{\firstpublicationyear}%
+% The commands \cs{copyrightyear}\marg{year} and
+% \cs{firstpublicationyear}\marg{year} set
+% the year when the report was copyrighted and first published. The
+% default is the current year.
+%
+% \DescribeMacro{\reportyear}%
+% \DescribeMacro{\reportmonth}%
+% Sometimes the report year or month might be different from the
+% copyright year. You can set them with the commands
+% \cs{reportyear}\marg{year} and \cs{reportmonth}\marg{month}. The
+% default is the copyright year and the current month.
+%
+% \DescribeMacro{\reportindex}%
+% The index of the report is set by the command
+% \cs{reportindex}\marg{index}.
+%
+% \DescribeMacro{\blurb}%
+% Amnesty International reports include a short blurb up to 200~words.
+% The macro \cs{blurb}\marg{blurb text} sets them.
+%
+%\subsection{Main matter}
+%\label{sec:ug_mainmatter}
+%
+% \DescribeMacro{\mainmatter}%
+% The main section starts with the command \cs{mainmatter}. The R
+% template provides it automatically.
+%
+%\subsection{Colors}
+%\label{sec:ug_colors}
+%
+% The class defines the following colors
+% \begin{enumerate}
+% \item |AmnestyYellow|, the primary color.
+% \item |AmnestyGray1|, |AmnestyGray2|, |AmnestyGray3|,
+% |AmnestyGray4|, |AmnestyGray5|, the grayscale from the lightest to
+% the darkest.
+% \end{enumerate}
+%
+%
+%
+%\subsection{Glossary}
+%\label{sec:ug-glossary}
+%
+% \DescribeEnv{AmnestyGlossary}%
+% Amnesty international reports may be accompanied by a glossary. A
+% glossary is introduced by the environment |AmnestyGlossary|. It has one
+% optional parameter: the maximal size of the word defined in the
+% table, by default 5em. The glossary entries are |tabular| entries:
+% the word to be defined is separated from the definition by |&|, and
+% definitions are ended by |\\|, for example (from
+% \url{https://www.amnesty.org/en/latest/campaigns/2015/07/beginners-guide-human-rights-jargon/}):
+% \begin{verbatim}
+% \begin{AmnestyGlossary}[3em]
+% Commute &
+% Commute means to replace a punishment, usually a death
+% sentence, with a less severe one. For example, Amnesty called for
+% the USA to commute to time served the 35-year jail sentence of
+% whistleblower Chelsea Manning, who had been arrested after leaking
+% classified government material. \\
+% Crimes against humanity &
+% When certain acts---including murder, torture and slavery---form
+% part of a widespread attack on a civilian population by a state or
+% organization. Unlike war crimes, they can take place at times of
+% peace as well as during conflict. The Rwandan genocide of 1994 is
+% one example of a crime against humanity. \\
+% Extrajudicial executions &
+% Unlawful killings ordered by a government, or committed with its
+% knowledge and support. They can be carried out by the military,
+% police, or by civilians working with government forces. For
+% example, Hamas forces in Gaza committed serious human rights
+% abuses, including extrajudicial executions, torture and
+% abductions, during the 2014 Gaza/Israel conflict. \\
+% Freedom of expression &
+% The right to seek, receive and share information and ideas,
+% without fear or interference. It is closely linked with freedom of
+% association (the right to meet with anyone you choose, for
+% example, to form and join clubs, societies or trade unions) and
+% the right to take part in a peaceful assembly, such as a
+% demonstration or public meeting. \\
+% \end{AmnestyGlossary}
+% \end{verbatim}
+%
+%
+%\subsection{Quotation styles}
+%\label{sec:ug_quotation}
+%
+% \DescribeEnv{quote}%
+% \DescribeMacro{attribution}%
+% There are several quotations styles used by Amnesty International
+% style. The most ubiquitous one is ``display quotes'', which is used
+% by the |quote| environment. This is the
+% style that is translated from the Markdown quotation style, with |>|
+% marks. It has a special command \cs{attribution}, which should be
+% used at the end of the quote, for example,
+% \begin{verbatim}
+% \begin{quote}
+% All human beings are born free and equal in dignity and
+% rights. They are endowed with reason and conscience and should act
+% towards one another in a spirit of brotherhood.
+%
+% \attribution{Universal Declaration of Human Rights}
+% \end{quote}
+% \end{verbatim}
+%
+% The equivalent Markdown syntax is
+% \begin{verbatim}
+% > All human beings are born free and equal in dignity and
+% > rights. They are endowed with reason and conscience and should act
+% > towards one another in a spirit of brotherhood.
+% >
+% > \attribution{Universal Declaration of Human Rights}
+% \end{verbatim}
+%
+%
+%
+%\subsection{Figures and tables}
+%\label{sec:ug_floats}
+%
+% Figures and tables by default are typeset with the `here` placement
+% option. You should put the caption of a table \emph{before} the
+% table, and the caption of a figure \emph{after} the figure. You can
+% use \cs{FloatBarrier} command to stop figures and tables from
+% moving.
+%
+% \DescribeMacro{\sideTableCaptions}%
+% \DescribeMacro{\sideFigureCaptions}%
+% \DescribeMacro{\normalTableCaptions}%
+% \DescribeMacro{\normalFigureCaptions}%
+% The style allows figures and tables with right side captions. The
+% commands \cs{sideTableCaptions} and \cs{sideFigureCaptions} switch
+% to this style, while the commands \cs{normalTableCaptions} and
+% \cs{normalFigureCaptions} switch to the standard style.
+%
+%
+% \clearpage
+% \StopEventually
+%
+%\section{Implementation}
+%\label{sec:impl}
+%
+%\subsection{Identification}
+%\label{sec:ident}
+%
+% We start with the declaration who we are. Most |.dtx| files put
+% driver code in a separate driver file |.drv|. We roll this code into the
+% main file, and use the pseudo-guard |<gobble>| for it.
+% \begin{macrocode}
+%<class>\NeedsTeXFormat{LaTeX2e}
+%<*gobble>
+\ProvidesFile{amnestyreport.dtx}
+%</gobble>
+%<class>\ProvidesClass{amnestyreport}
+[2024/01/12 v1.2 Typesetting articles for Amnesty International]
+% \end{macrocode}
+%
+%
+%
+% And the driver code:
+% \begin{macrocode}
+%<*gobble>
+\documentclass{ltxdoc}
+\usepackage[breaklinks,colorlinks,linkcolor=black,citecolor=black,
+pagecolor=black,urlcolor=black,hyperindex=false]{hyperref}
+\usepackage{siunitx}
+\PageIndex
+\CodelineIndex
+\RecordChanges
+\EnableCrossrefs
+\begin{document}
+ \DocInput{amnestyreport.dtx}
+\end{document}
+%</gobble>
+%<*class>
+% \end{macrocode}
+%
+%\subsection{Options}
+%\label{sec:options}
+%
+% We pass paper size to \textsl{geometry}
+% \begin{macrocode}
+\DeclareOption{a4paper}{\PassOptionsToPackage{\CurrentOption}{geometry}}
+\DeclareOption{letterpaper}{\PassOptionsToPackage{\CurrentOption}{geometry}}
+% \end{macrocode}
+%
+% \begin{macro}{\ifamnesty@fonts}
+% \changes{v1.1}{2023/11/28}{Introduced macro}
+% The switch whether to use Amensty proprietary font
+% \begin{macrocode}
+\newif\ifamnesty@fonts
+\amnesty@fontstrue
+% \end{macrocode}
+% \end{macro}
+%
+% Setting the font
+% \begin{macrocode}
+\DeclareOption{amnestyfonts}{\amnesty@fontstrue}
+\DeclareOption{freefonts}{\amnesty@fontsfalse}
+% \end{macrocode}
+%
+% \begin{macro}{\ifamnesty@logo}
+% \changes{v1.1}{2023/11/28}{Introduced macro}
+% Whether we have the logo
+% \begin{macrocode}
+\newif\ifamnesty@logo
+\amnesty@logotrue
+% \end{macrocode}
+% \end{macro}
+%
+% Setting the logo
+% \begin{macrocode}
+\DeclareOption{logo}{\amnesty@logotrue}
+\DeclareOption{nologo}{\amnesty@logofalse}
+% \end{macrocode}
+%
+% And executing the options
+% \begin{macrocode}
+\ExecuteOptions{a4paper,amnestyfonts}
+\ProcessOptions\relax
+% \end{macrocode}
+%
+% Sanity check whether logo exists
+% \begin{macrocode}
+\IfFileExists{Amnesty_logo.png}{}{\amnesty@logofalse}
+% \end{macrocode}
+%
+%
+%\subsection{Loading Class and Packages}
+%\label{sec:loading}
+%
+% We start with the base class
+% \begin{macrocode}
+\LoadClass{article}
+% \end{macrocode}
+%
+% Geometry to set up margins
+% \begin{macrocode}
+\RequirePackage[top=1.02in, bottom=1.38in,
+left=1.26in, right=1.26in, footskip=40pt]{geometry}
+% \end{macrocode}
+%
+% We suppress hyphenation
+% \begin{macrocode}
+\usepackage[none]{hyphenat}
+% \end{macrocode}
+%
+% URLs
+% \begin{macrocode}
+\RequirePackage[colorlinks=false]{hyperref}
+\def\UrlFont{}
+\def\sectionautorefname{Section}
+\def\subsectionautorefname{Section}
+\def\subsubsectionautorefname{Section}
+% \end{macrocode}
+%
+% We need graphics
+% \begin{macrocode}
+\RequirePackage{graphicx}
+% \end{macrocode}
+%
+% We use biblatex
+% \begin{macrocode}
+\RequirePackage[backend=bibtex]{biblatex}
+% \end{macrocode}
+%
+% Due to the way Rmarkdown works, we add \cs{citep} and \cs{citet}
+% commands
+% \begin{macro}{\citep}
+% \begin{macrocode}
+\RequirePackage{xparse}
+\NewDocumentCommand{\citep}{oom}{%
+ \IfNoValueTF{#2}{%
+ \IfNoValueTF{#1}{\footfullcite{#3}}{\footfullcite[][#1]{#3}}}{%
+ \footfullcite[#1][#2]{#3}}}
+\let\citet\citep
+% \end{macrocode}
+% \end{macro}
+%
+% We need \cs{FloatBarrier} command
+% \begin{macrocode}
+\RequirePackage{placeins}
+% \end{macrocode}
+%
+% We need framed for splitting leftbar boxes
+% \begin{macrocode}
+\RequirePackage{framed}
+% \end{macrocode}
+%
+% \changes{v1.2}{2024/01/14}{Added sidecap package}
+% We need sidecap to typeset sidewise captions.
+% \begin{macrocode}
+\RequirePackage[rightcaption]{sidecap}
+\def\SC@figure@vpos{t}
+% \end{macrocode}
+%
+%\subsection{Fonts}
+%\label{sec:fonts}
+%
+% \changes{v1.2}{2024/01/02}{Added Inconsolata as monofont}
+%
+% \begin{macrocode}
+\RequirePackage{fontspec}
+\ifamnesty@fonts
+ \ClassInfo{amnestyreport}{Using Amnesty International fonts}
+ \setmainfont{AmnestyTradeGothic-Light.ttf}[
+ BoldFont=AmnestyTradeGothic-Bd2.ttf,
+ ItalicFont=AmnestyTradeGothic-LightObl.ttf,
+ BoldItalicFont=AmnestyTradeGothic-Bd2Obl.ttf]
+
+ \newfontfamily\condensed{AmnestyTradeGothic-Cn18.ttf}[
+ BoldFont=AmnestyTradeGothic-BdCn20.ttf,
+ ItalicFont=AmnestyTradeGothic-Cn18Obl.ttf,
+ BoldItalicFont=AmnestyTradeGothic-BdCn20Ob.ttf]
+\else
+ \ClassInfo{amnestyreport}{Using free fonts}
+ \setmainfont{texgyreadventor-regular.otf}[
+ BoldFont=texgyreadventor-bold.otf,
+ ItalicFont=texgyreadventor-italic.otf,
+ BoldItalicFont=texgyreadventor-bolditalic.otf]
+
+ \newfontfamily\condensed{QTHelvetCnd-Light.otf}[
+ BoldFont=QTHelvetCnd.otf,
+ ItalicFont=QTHelvetCnd-Light.otf,
+ BoldItalicFont=QTHelvetCnd.otf]
+\fi
+\setmonofont[StylisticSet={1,2,3}]{Inconsolatazi4-Regular.otf}[
+ BoldFont=Inconsolatazi4-Bold.otf]
+\RequirePackage{fontawesome5}
+% \end{macrocode}
+%
+%
+%\subsection{Paragraphing}
+%\label{sec:paragraphing}
+%
+% The base size is 9pt. This is taken from size9.clo
+% \begin{macrocode}
+\renewcommand\normalsize{%
+ \@setfontsize\normalsize\@ixpt\@xipt%
+ \abovedisplayskip 8\p@ \@plus4\p@ \@minus4\p@
+ \abovedisplayshortskip \z@ \@plus3\p@
+ \belowdisplayshortskip 5\p@ \@plus3\p@ \@minus3\p@
+ \belowdisplayskip \abovedisplayskip
+ \let\@listi\@listI}
+\renewcommand\small{%
+ \@setfontsize\small\@viiipt\@ixpt%
+ \abovedisplayskip 5\p@ \@plus2\p@ \@minus2\p@
+ \abovedisplayshortskip \z@ \@plus1\p@
+ \belowdisplayshortskip 3\p@ \@plus\p@ \@minus2\p@
+ \def\@listi{\leftmargin\leftmargini
+ \topsep 3\p@ \@plus\p@ \@minus\p@
+ \parsep 2\p@ \@plus\p@ \@minus\p@
+ \itemsep \parsep}%
+ \belowdisplayskip \abovedisplayskip
+}
+\renewcommand\footnotesize{%
+ \@setfontsize\footnotesize\@viipt\@viiipt
+ \abovedisplayskip 4\p@ \@plus2\p@ \@minus2\p@
+ \abovedisplayshortskip \z@ \@plus1\p@
+ \belowdisplayshortskip 2.5\p@ \@plus\p@ \@minus\p@
+ \def\@listi{\leftmargin\leftmargini
+ \topsep 3\p@ \@plus\p@ \@minus\p@
+ \parsep 2\p@ \@plus\p@ \@minus\p@
+ \itemsep \parsep}%
+ \belowdisplayskip \abovedisplayskip
+}
+\renewcommand\scriptsize{\@setfontsize\scriptsize\@vipt\@viipt}
+\renewcommand\tiny{\@setfontsize\tiny\@vpt\@vipt}
+\renewcommand\large{\@setfontsize\large\@xpt\@xiipt}
+\renewcommand\Large{\@setfontsize\Large\@xipt{13}}
+\renewcommand\LARGE{\@setfontsize\LARGE\@xiipt{14}}
+\renewcommand\huge{\@setfontsize\huge\@xivpt{18}}
+\renewcommand\Huge{\@setfontsize\Huge\@xviipt{22}}
+\setlength\parskip{6pt}
+\setlength\parindent\z@
+% \end{macrocode}
+%
+%
+%\subsection{Colors}
+%\label{sec:colors}
+%
+% \begin{macrocode}
+\RequirePackage{xcolor}
+\definecolor{AmnestyYellow}{RGB/cmyk}{255,255,0/0,0,1,0}
+\definecolor{AmnestyGray1}{RGB/cmyk}{228,228,228/0,0,0,15}
+\definecolor{AmnestyGray2}{RGB/cmyk}{178,178,178/0,0,0,32}
+\definecolor{AmnestyGray3}{RGB/cmyk}{118,118,118/0,0,0,64}
+\definecolor{AmnestyGray4}{RGB/cmyk}{82,82,82/0,0,0,79}
+\definecolor{AmnestyGray4}{RGB/cmyk}{37,37,37/0,0,0,97}
+\RequirePackage{soul}
+\sethlcolor{AmnestyYellow}
+% \end{macrocode}
+%
+%
+%\subsection{Setting up top matter}
+%\label{sec:top_matter}
+%
+% \begin{macro}{\titleimage}
+% The title image
+% \begin{macrocode}
+\newcommand\titleimage[1]{\def\@titleimage{#1}}
+\titleimage{}
+% \end{macrocode}
+% \end{macro}
+%
+% \begin{macro}{\titleimagecaption}
+% The caption for the image
+% \begin{macrocode}
+\newcommand\titleimagecaption[1]{\def\@titleimagecaption{#1}}
+\titleimagecaption{}
+% \end{macrocode}
+% \end{macro}
+%
+% \begin{macro}{\subtitle}
+% The subitle
+% \begin{macrocode}
+\newcommand\subtitle[1]{\def\@subtitle{#1}}
+\subtitle{}
+% \end{macrocode}
+% \end{macro}
+%
+% \begin{macro}{\copyrightyear}
+% The copyright year
+% \begin{macrocode}
+\newcommand\copyrightyear[1]{\def\@copyrightyear{#1}}
+\copyrightyear{\the\year}
+% \end{macrocode}
+% \end{macro}
+%
+% \begin{macro}{\firstpublicationyear}
+% The publication year
+% \begin{macrocode}
+\newcommand\firstpublicationyear[1]{\def\@firstpublicationyear{#1}}
+\firstpublicationyear{\@copyrightyear}
+% \end{macrocode}
+% \end{macro}
+%
+% \begin{macro}{\reportyear}
+% The report year
+% \begin{macrocode}
+\newcommand\reportyear[1]{\def\@reportyear{#1}}
+\reportyear{\@copyrightyear}
+% \end{macrocode}
+% \end{macro}
+%
+% \begin{macro}{\reportmonth}
+% The report month
+% \begin{macrocode}
+\newcommand\reportmonth[1]{\def\@reportmonth{#1}}
+\reportmonth{\ifcase\month\or
+ January\or February\or March\or April\or May\or June\or
+ July\or August\or September\or October\or November\or December\fi}
+% \end{macrocode}
+% \end{macro}
+%
+%
+% \begin{macro}{\reportindex}
+% The index
+% \begin{macrocode}
+\newcommand\reportindex[1]{\def\@reportindex{#1}}
+\reportindex{XXXX XX/XX/XXX}
+% \end{macrocode}
+% \end{macro}
+%
+% \begin{macro}{\blurb}
+% The blurb
+% \begin{macrocode}
+\newcommand\blurb[1]{\def\@blurb{#1}}
+\blurb{}
+% \end{macrocode}
+% \end{macro}
+%
+%
+%\subsection{Typesetting top matter}
+%\label{sec:maketitle}
+%
+% \begin{macro}{\frontmatter}
+% We use empty page style for the front matter
+% \begin{macrocode}
+\newcommand\frontmatter{%
+ \pagenumbering{arabic}%
+ \pagestyle{empty}}
+% \end{macrocode}
+% \end{macro}
+%
+% \begin{macro}{\maketitle}
+% The \cs{maketitle} command\ldots
+% \begin{macrocode}
+\renewcommand{\maketitle}{%
+ \newgeometry{top=0.55in, bottom=1.18in,
+ left=0.55in, right=0.55in, footskip=20pt}%
+ \pagestyle{titlepage}%
+ \ifx\@titleimage\@empty
+ \ClassWarningNoLine{amnestyreport}{You did not define the title
+ image}%
+ \else
+ \includegraphics[width=18.17cm]{\@titleimage}\par
+ \fi
+ \ifx\@title\@empty\else
+ {\condensed\bfseries\fontsize{48pt}{48pt}\selectfont
+ \hl{\MakeUppercase{\@title}}\par}%
+ \fi
+ \ifx\@subtitle\@empty\else
+ {\condensed\fontsize{22pt}{22pt}\selectfont
+ \MakeUppercase{\@subtitle}\par}%
+ \fi
+ \clearpage
+ \thispagestyle{backtitlepage}%
+ {\condensed\bfseries\fontsize{22pt}{22pt}\selectfont
+ \hl{Amnesty International is a movement of 10 million people
+ which mobilizes the humanity in everyone and campaigns
+ for change so we can all enjoy our human rights. Our vision
+ is of a world where those in power keep their promises,
+ respect international law and are held to account. We are
+ independent of any government, political ideology, economic
+ interest or religion and are funded mainly by our membership
+ and individual donations. We believe that acting in solidarity
+ and compassion with people everywhere can change our
+ societies for the better.}\par}
+\vfill
+\parbox[t]{0.48\textwidth}{\condensed\footnotesize
+ \textcopyright~Amnesty International~\@copyrightyear
+
+Except where otherwise noted, content in this document is licensed
+under a Creative Commons (attribution, non-commercial, no derivatives,
+international 4.0) licence.
+\url{https://creativecommons.org/licenses/by-nc-nd/4.0/legalcode}.
+
+For more information please visit the permissions page on our website:
+\href{https://www.amnesty.org}{www.amnesty.org}.
+
+Where material is attributed to a copyright owner other than Amnesty International this
+material is not subject to the Creative Commons licence.
+
+First published in \@firstpublicationyear\\
+by Amnesty International Ltd\\
+Peter Benenson House, 1 Easton Street\\
+London WC1X 0DW, UK}\hfill
+\parbox[t]{0.48\textwidth}{\condensed\footnotesize
+ \ifx\@titleimagecaption\@empty\else
+ $\leftarrow$\faEye[regular] \raggedright\itshape\textbf{Cover photo:} \@titleimagecaption\fi}
+\restoregeometry
+\pagestyle{empty}}
+
+% \end{macrocode}
+% \end{macro}
+%
+%
+%\subsection{Main matter}
+%\label{sec:mainmatter}
+%
+% \begin{macro}{\mainmatter}
+% THe main matter
+\newcommand\mainmatter{\cleardoublepage
+ \pagestyle{main}%
+}
+% \end{macro}
+%
+%
+%\subsection{Page styles}
+%\label{sec:page_styles}
+%
+% \begin{macro}{\amnesty@logo@graphics}
+% \changes{v1.1}{2023/11/28}{Introduced macro}
+% Either AI logo or a strut
+% \begin{macrocode}
+\def\amnesty@logo@graphics{%
+ \ifamnesty@logo
+ \includegraphics[height=0.5in]{Amnesty_logo}%
+ \else
+ \rule{0pt}{0.5in}%
+ \fi}
+% \end{macrocode}
+% \end{macro}
+%
+% \begin{macrocode}
+\RequirePackage{fancyhdr}
+\renewcommand{\headrulewidth}{0pt}
+\renewcommand{\footrulewidth}{0pt}
+\fancypagestyle{titlepage}{%
+ \fancyhf{}%
+ \fancyfoot[R]{\raisebox{-\height}{\amnesty@logo@graphics}}%
+}
+\fancypagestyle{backtitlepage}{%
+ \fancyhf{}%
+ \fancyfoot[L]{\bfseries Index: \@reportindex\\
+ Original language: English\\
+ \large\href{https://amnesty.org}{amnesty.org}}%
+ \fancyfoot[R]{\raisebox{-\height}{\amnesty@logo@graphics}}%
+}
+\fancypagestyle{main}{%
+ \fancyhf{}%
+ \fancyfoot[L]{\condensed\footnotesize\textbf{\MakeUppercase{\@title}}\par
+ \ifx\@subtitle\@empty\else\condensed\MakeUppercase{\@subtitle}\par\fi
+ Amnesty International
+ }%
+ \fancyfoot[R]{\normalsize\normalfont\thepage\hspace{1in}}%
+}
+\fancypagestyle{backcoverpage}{%
+ \fancyhf{}%
+ \fancyfoot[L]{\normalsize\normalfont
+ INDEX: \mbox{\@reportindex}\\
+ \MakeUppercase{\@reportmonth~\@reportyear}\\
+ LANGUAGE: ENGLISH\\
+ \LARGE\bfseries\href{https://amnesty.org}{amnesty.org}}%
+ \fancyfoot[R]{\raisebox{-\height}{\amnesty@logo@graphics}\hspace{1in}}%
+}
+% \end{macrocode}
+%
+%
+%
+%\subsection{Sectioning}
+%\label{sec:sectioning}
+%
+% \begin{macro}{\section}
+% The section
+% \begin{macrocode}
+\renewcommand\section{\@startsection {section}{1}{\z@}%
+ {-3.5ex \@plus -1ex \@minus -.2ex}%
+ {.5ex \@plus.2ex}%
+ {\condensed\fontsize{45pt}{45pt}\selectfont\bfseries\raggedright\MakeUppercase}}
+% \end{macrocode}
+% \end{macro}
+%
+% \begin{macro}{\subsection}
+% Subsection
+% \begin{macrocode}
+\renewcommand\subsection{\@startsection{subsection}{2}{\z@}%
+ {-3.25ex\@plus -1ex \@minus -.2ex}%
+ {0.5ex \@plus .2ex}%
+ {\condensed\fontsize{21pt}{21pt}\selectfont\bfseries\raggedright\MakeUppercase}}
+% \end{macrocode}
+% \end{macro}
+%
+% \begin{macro}{\subsubsection}
+\renewcommand\subsubsection{\@startsection{subsubsection}{3}{\z@}%
+ {-3.25ex\@plus -1ex \@minus -.2ex}%
+ {0.5ex \@plus .2ex}%
+ {\condensed\fontsize{16pt}{16pt}\selectfont\bfseries\raggedright\MakeUppercase}}
+% \end{macro}
+%
+% \begin{macro}{\paragraph}
+\renewcommand\paragraph{\@startsection{paragraph}{4}{\z@}%
+ {3.25ex \@plus1ex \@minus.2ex}%
+ {1sp}%
+ {\condensed\fontsize{11pt}{11pt}\selectfont\bfseries\raggedright\MakeUppercase}}
+% \end{macro}
+%
+%
+%\subsection{Table of contents formatting}
+%\label{sec:toc}
+%
+% TOC formatting
+% \begin{macro}{\l@section}
+% Section formatting
+% \begin{macrocode}
+\renewcommand*\l@section[2]{%
+ \ifnum \c@tocdepth >\z@
+ \addpenalty\@secpenalty
+ \addvspace{1.0em \@plus\p@}%
+ \setlength\@tempdima{1.5em}%
+ \begingroup
+ \def\numberline##1{##1~}%
+ \parindent \z@ \rightskip \@pnumwidth
+ \parfillskip -\@pnumwidth
+ \leavevmode \condensed\fontsize{11pt}{11pt}\selectfont\bfseries
+ \advance\leftskip\@tempdima
+ \hskip -\leftskip
+ \MakeUppercase{#1}\nobreak\hfil
+ \nobreak\hb@xt@\@pnumwidth{\hss #2%
+ \kern-\p@\kern\p@}\par
+ \endgroup
+ \fi}
+% \end{macrocode}
+% \end{macro}
+%
+% \begin{macro}{\l@subsection}
+% Subsection formatting
+% \begin{macrocode}
+\renewcommand*\l@subsection[2]{%
+ \ifnum \c@tocdepth >1
+ \addvspace{0.5em \@plus\p@}%
+ \setlength\@tempdima{2em}%
+ \begingroup
+ \def\numberline##1{##1~}%
+ \parindent \z@ \rightskip \@pnumwidth
+ \parfillskip -\@pnumwidth
+ \leavevmode \condensed\fontsize{10pt}{10pt}\selectfont
+ \advance\leftskip\@tempdima
+ \hskip -\leftskip
+ \MakeUppercase{#1}\nobreak\hfil
+ \nobreak\hb@xt@\@pnumwidth{\hss #2%
+ \kern-\p@\kern\p@}\par
+ \endgroup
+ \fi}
+% \end{macrocode}
+% \end{macro}
+%
+% \begin{macro}{\l@subsubsection}
+% Subsubsection formatting
+% \begin{macrocode}
+\renewcommand*\l@subsubsection[2]{%
+ \ifnum \c@tocdepth >2
+ \addvspace{0.5em \@plus\p@}%
+ \setlength\@tempdima{2.5em}%
+ \begingroup
+ \def\numberline##1{##1~}%
+ \parindent \z@ \rightskip \@pnumwidth
+ \parfillskip -\@pnumwidth
+ \leavevmode \condensed\fontsize{9pt}{9pt}\selectfont
+ \advance\leftskip\@tempdima
+ \hskip -\leftskip
+ \MakeUppercase{#1}\nobreak\hfil
+ \nobreak\hb@xt@\@pnumwidth{\hss #2%
+ \kern-\p@\kern\p@}\par
+ \endgroup
+ \fi}
+% \end{macrocode}
+% \end{macro}
+%
+%
+%\subsection{Figures and tables}
+%\label{sec:floats}
+%
+% We use the caption package for the formatting
+% \begin{macrocode}
+\RequirePackage[font=it]{caption}
+\DeclareCaptionLabelFormat{table}{$\downarrow$\faEye[regular]\itshape~
+ #1 #2}
+\DeclareCaptionLabelFormat{figure}{$\uparrow$\faEye[regular]\itshape~
+ #1 #2}
+\DeclareCaptionLabelFormat{side}{$\leftarrow$\faEye[regular]\itshape~
+ #1 #2}
+\captionsetup[table]{labelformat=table}
+\captionsetup[figure]{labelformat=figure}
+\captionsetup[SCfigure]{labelformat=side}
+\captionsetup[SCtable]{labelformat=side}
+\def\fps@figure{hb}
+\def\fps@table{hb}
+\def\fps@SCfigure{hb}
+\def\fps@SCtable{hb}
+% \end{macrocode}
+%
+% \begin{macro}{\sideTableCaptions}
+% \changes{v1.2}{2024/01/14}{Added macro}
+% Switching to the sideways tables.
+% \begin{macrocode}
+\let\table@AI@Orig\table
+\let\endtable@AI@Orig\endtable
+\def\sideTableCaptions{%
+ \def\table{\SCtable[50]}%
+ \def\endtable{\endSCtable}}
+% \end{macrocode}
+% \end{macro}
+%
+% \begin{macro}{\normalTableCaptions}
+% \changes{v1.2}{2024/01/14}{Added macro}
+% Switching to the normal tables.
+% \begin{macrocode}
+\def\normalTableCaptions{%
+ \def\table{\table@AI@Orig}%
+ \def\endtable{\endtable@AI@Orig}}
+% \end{macrocode}
+% \end{macro}
+%
+% \begin{macro}{\if@AI@sideFigures}
+% \changes{v1.2}{2024/01/14}{Added macro}
+% Since the typesetting of photos depends on the typesetting of
+% figures, we need the switch
+% \begin{macrocode}
+\newif\if@AI@sideFigures
+\@AI@sideFiguresfalse
+% \end{macrocode}
+% \end{macro}
+%
+% \begin{macro}{\sideFigureCaptions}
+% \changes{v1.2}{2024/01/14}{Added macro}
+% Switching to the sideways figures.
+% \begin{macrocode}
+\let\figure@AI@Orig\figure
+\let\endfigure@AI@Orig\endfigure
+\def\sideFigureCaptions{%
+ \@AI@sideFigurestrue
+ \def\figure{\SCfigure[50]}%
+ \def\endfigure{\endSCfigure}}
+% \end{macrocode}
+% \end{macro}
+%
+% \begin{macro}{\normalFigureCaptions}
+% \changes{v1.2}{2024/01/14}{Added macro}
+% Switching to the normal figures.
+% \begin{macrocode}
+\def\normalFigureCaptions{%
+ \@AI@sideFiguresfalse
+ \def\figure{\figure@AI@Orig}%
+ \def\endfigure{\endfigure@AI@Orig}}
+% \end{macrocode}
+% \end{macro}
+%
+%\subsection{Footnotes}
+%\label{sec:footnotes}
+%
+% \begin{macro}{\@makefntext}
+% Our footnotes are not indented
+% \begin{macrocode}
+\renewcommand\@makefntext[1]{%
+ \raggedright\parindent\z@\hangindent2em%
+ \noindent
+ \@makefnmark\,#1}
+% \end{macrocode}
+% \end{macro}
+%
+%\subsection{Backmatter}
+%\label{sec:back}
+%
+% \begin{macro}{\backmatter}
+% The end of the report
+% \begin{macrocode}
+\newcommand\backmatter{%
+ \cleardoublepage
+ \thispagestyle{empty}%
+ \setbox\@tempboxa\vbox{\hsize=5in\condensed\fontsize{40pt}{40pt}\selectfont\bfseries
+ AMNESTY INTERNATIONAL
+ IS A GLOBAL MOVEMENT
+ FOR HUMAN RIGHTS.
+ WHEN INJUSTICE HAPPENS
+ TO ONE PERSON, IT
+ MATTERS TO US ALL.}%
+\textcolor{AmnestyYellow}{\rule{10pt}{\ht\@tempboxa}}\hspace{5pt}\box\@tempboxa
+\vfill
+
+\parbox[t]{0.45\textwidth}{\setlength{\parskip}{6pt}%
+ \condensed\fontsize{16pt}{16pt}\selectfont
+ CONTACT US
+
+\normalsize\normalfont
+\faEnvelope~\href{mailto:info@amnesty.org}{info@amnesty.org}
+
+\faPhone*~+44 (0)20 7413 5500}\hspace{0.05\textwidth}%
+\parbox[t]{0.45\textwidth}{\setlength{\parskip}{6pt}%
+ \condensed\fontsize{16pt}{16pt}\selectfont
+ JOIN THE CONVERSATION
+
+\normalsize\normalfont
+\faFacebook~\href{https://www.facebook.com/AmnestyGlobal}{www.facebook.com/AmnestyGlobal}
+
+\faTwitter~@Amnesty}\clearpage
+\thispagestyle{backcoverpage}%
+{\condensed\fontsize{28pt}{28pt}\bfseries\hl{\MakeUppercase{\@title}}\par}%
+\ifx\@subtitle\@empty\else
+{\condensed\fontsize{16pt}{16pt}\MakeUppercase{\@subtitle}\par}%
+\fi
+\bigskip
+\@blurb
+}
+
+% \end{macrocode}
+% \end{macro}
+%
+%
+%\subsection{Glossary}
+%\label{sec:glossary}
+%
+% Some packages for the glossary
+% \begin{macrocode}
+\RequirePackage{longtable, booktabs}
+\newdimen\@tempdimAI
+% \end{macrocode}
+%
+% \begin{macro}{\AmnestyGlossary}
+% \changes{v1.0}{2023/10/15}{Added macro}
+% Now glossary.
+% \begin{macrocode}
+\newenvironment{AmnestyGlossary}[1][5em]{%
+ \clearpage
+ \section*{Glossary}
+ \bgroup
+ \setlength\extrarowheight{1pt}%
+ \rowcolors{1}{AmnestyGray1}{white}%
+ \setlength\@tempdimAI{\textwidth}%
+ \addtolength\@tempdimAI{-2\tabcolsep}%
+ \addtolength\@tempdimAI{-#1}%
+ \begin{longtable}{p{#1}<{\raggedright}p{\@tempdimAI}<{\raggedright}}}{%
+ \end{longtable}\egroup}
+% \end{macrocode}
+% \end{macro}
+%
+%
+%\subsection{Lists}
+%\label{sec:lists}
+%
+% \begin{macro}{\quote}
+% \changes{v1.1}{2023/12/12}{Redefined macro}
+% Quotes have a special setup here. This is just ``leftbar'' from
+% framed.sty
+% \begin{macrocode}
+\renewenvironment{quote}{%
+ \def\FrameCommand{\vrule width 6pt \hspace{10pt}}%
+ \MakeFramed {\advance\hsize-\width \FrameRestore}%
+ \vskip0pt\Huge\bfseries\condensed\raggedright\strut\relax}%
+{\strut\vskip5pt\endMakeFramed}
+% \end{macrocode}
+% \end{macro}
+%
+% \begin{macro}{\attribution}
+% \changes{v1.1}{2023/12/12}{Introduced macro}
+% Attribution for quotations
+% \begin{macrocode}
+\def\attribution#1{\par\normalfont\mdseries\normalsize\raggedright #1}
+% \end{macrocode}
+% \end{macro}
+%
+% \begin{macro}{\tightlist}
+% \changes{v1.2}{2024/01/12}{Introduced macro}
+% Pandoc defines `tightlist`, which it uses for |*|-defined lists
+% \begin{macrocode}
+\def\tightlist{%
+ \setlength{\itemsep}{0pt}\setlength{\parskip}{0pt}}
+% \end{macrocode}
+% \end{macro}
+%
+%\subsection{End of Class}
+%\label{end}
+%
+%
+% \begin{macrocode}
+\normalsize\normalfont\raggedright
+\frontmatter
+%</class>
+% \end{macrocode}
+%
+%\Finale
+%\clearpage
+%
+%\PrintChanges
+%\clearpage
+%\PrintIndex
+%
+\endinput
diff --git a/Master/texmf-dist/source/latex/amnestyreport/amnestyreport.ins b/Master/texmf-dist/source/latex/amnestyreport/amnestyreport.ins
new file mode 100644
index 00000000000..8b97edc5f8c
--- /dev/null
+++ b/Master/texmf-dist/source/latex/amnestyreport/amnestyreport.ins
@@ -0,0 +1,29 @@
+%
+% Doctrip file for aomart
+% This file is in public domain
+% $Id: aomart.ins,v 1.2 2017/01/26 23:31:37 boris Exp $
+%
+\def\batchfile{amnestyreport.ins}
+\input docstrip
+\keepsilent
+\showprogress
+
+
+\askforoverwritefalse
+
+\generate{%
+ \file{amnestyreport.cls}{\from{amnestyreport.dtx}{class}}}
+
+\obeyspaces
+\Msg{*****************************************************}%
+\Msg{* Congratulations! You successfully generated the *}%
+\Msg{* amnestyreport package. *}%
+\Msg{* *}%
+\Msg{* Please move the file amnestyreport.cls to where *}%
+\Msg{* LaTeX files are stored in your system. *}%
+\Msg{* The manual is amnestyreport.pdf. *}%
+\Msg{* *}%
+\Msg{* The package is released under LPPL *}%
+\Msg{* *}%
+\Msg{* Happy TeXing! *}%
+\Msg{*****************************************************}% \ No newline at end of file
diff --git a/Master/texmf-dist/tex/latex/amnestyreport/amnestyreport.cls b/Master/texmf-dist/tex/latex/amnestyreport/amnestyreport.cls
new file mode 100644
index 00000000000..f4e4f4d7783
--- /dev/null
+++ b/Master/texmf-dist/tex/latex/amnestyreport/amnestyreport.cls
@@ -0,0 +1,435 @@
+%%
+%% This is file `amnestyreport.cls',
+%% generated with the docstrip utility.
+%%
+%% The original source files were:
+%%
+%% amnestyreport.dtx (with options: `class')
+%%
+%% IMPORTANT NOTICE:
+%%
+%% For the copyright see the source file.
+%%
+%% Any modified versions of this file must be renamed
+%% with new filenames distinct from amnestyreport.cls.
+%%
+%% For distribution of the original source see the terms
+%% for copying and modification in the file amnestyreport.dtx.
+%%
+%% This generated file may be distributed as long as the
+%% original source files, as listed above, are part of the
+%% same distribution. (The sources need not necessarily be
+%% in the same archive or directory.)
+%% \CharacterTable
+%% {Upper-case \A\B\C\D\E\F\G\H\I\J\K\L\M\N\O\P\Q\R\S\T\U\V\W\X\Y\Z
+%% Lower-case \a\b\c\d\e\f\g\h\i\j\k\l\m\n\o\p\q\r\s\t\u\v\w\x\y\z
+%% Digits \0\1\2\3\4\5\6\7\8\9
+%% Exclamation \! Double quote \" Hash (number) \#
+%% Dollar \$ Percent \% Ampersand \&
+%% Acute accent \' Left paren \( Right paren \)
+%% Asterisk \* Plus \+ Comma \,
+%% Minus \- Point \. Solidus \/
+%% Colon \: Semicolon \; Less than \<
+%% Equals \= Greater than \> Question mark \?
+%% Commercial at \@ Left bracket \[ Backslash \\
+%% Right bracket \] Circumflex \^ Underscore \_
+%% Grave accent \` Left brace \{ Vertical bar \|
+%% Right brace \} Tilde \~}
+\NeedsTeXFormat{LaTeX2e}
+\ProvidesClass{amnestyreport}
+[2024/01/12 v1.2 Typesetting articles for Amnesty International]
+\DeclareOption{a4paper}{\PassOptionsToPackage{\CurrentOption}{geometry}}
+\DeclareOption{letterpaper}{\PassOptionsToPackage{\CurrentOption}{geometry}}
+\newif\ifamnesty@fonts
+\amnesty@fontstrue
+\DeclareOption{amnestyfonts}{\amnesty@fontstrue}
+\DeclareOption{freefonts}{\amnesty@fontsfalse}
+\newif\ifamnesty@logo
+\amnesty@logotrue
+\DeclareOption{logo}{\amnesty@logotrue}
+\DeclareOption{nologo}{\amnesty@logofalse}
+\ExecuteOptions{a4paper,amnestyfonts}
+\ProcessOptions\relax
+\IfFileExists{Amnesty_logo.png}{}{\amnesty@logofalse}
+\LoadClass{article}
+\RequirePackage[top=1.02in, bottom=1.38in,
+left=1.26in, right=1.26in, footskip=40pt]{geometry}
+\usepackage[none]{hyphenat}
+\RequirePackage[colorlinks=false]{hyperref}
+\def\UrlFont{}
+\def\sectionautorefname{Section}
+\def\subsectionautorefname{Section}
+\def\subsubsectionautorefname{Section}
+\RequirePackage{graphicx}
+\RequirePackage[backend=bibtex]{biblatex}
+\RequirePackage{xparse}
+\NewDocumentCommand{\citep}{oom}{%
+ \IfNoValueTF{#2}{%
+ \IfNoValueTF{#1}{\footfullcite{#3}}{\footfullcite[][#1]{#3}}}{%
+ \footfullcite[#1][#2]{#3}}}
+\let\citet\citep
+\RequirePackage{placeins}
+\RequirePackage{framed}
+\RequirePackage[rightcaption]{sidecap}
+\def\SC@figure@vpos{t}
+\RequirePackage{fontspec}
+\ifamnesty@fonts
+ \ClassInfo{amnestyreport}{Using Amnesty International fonts}
+ \setmainfont{AmnestyTradeGothic-Light.ttf}[
+ BoldFont=AmnestyTradeGothic-Bd2.ttf,
+ ItalicFont=AmnestyTradeGothic-LightObl.ttf,
+ BoldItalicFont=AmnestyTradeGothic-Bd2Obl.ttf]
+
+ \newfontfamily\condensed{AmnestyTradeGothic-Cn18.ttf}[
+ BoldFont=AmnestyTradeGothic-BdCn20.ttf,
+ ItalicFont=AmnestyTradeGothic-Cn18Obl.ttf,
+ BoldItalicFont=AmnestyTradeGothic-BdCn20Ob.ttf]
+\else
+ \ClassInfo{amnestyreport}{Using free fonts}
+ \setmainfont{texgyreadventor-regular.otf}[
+ BoldFont=texgyreadventor-bold.otf,
+ ItalicFont=texgyreadventor-italic.otf,
+ BoldItalicFont=texgyreadventor-bolditalic.otf]
+
+ \newfontfamily\condensed{QTHelvetCnd-Light.otf}[
+ BoldFont=QTHelvetCnd.otf,
+ ItalicFont=QTHelvetCnd-Light.otf,
+ BoldItalicFont=QTHelvetCnd.otf]
+\fi
+\setmonofont[StylisticSet={1,2,3}]{Inconsolatazi4-Regular.otf}[
+ BoldFont=Inconsolatazi4-Bold.otf]
+\RequirePackage{fontawesome5}
+\renewcommand\normalsize{%
+ \@setfontsize\normalsize\@ixpt\@xipt%
+ \abovedisplayskip 8\p@ \@plus4\p@ \@minus4\p@
+ \abovedisplayshortskip \z@ \@plus3\p@
+ \belowdisplayshortskip 5\p@ \@plus3\p@ \@minus3\p@
+ \belowdisplayskip \abovedisplayskip
+ \let\@listi\@listI}
+\renewcommand\small{%
+ \@setfontsize\small\@viiipt\@ixpt%
+ \abovedisplayskip 5\p@ \@plus2\p@ \@minus2\p@
+ \abovedisplayshortskip \z@ \@plus1\p@
+ \belowdisplayshortskip 3\p@ \@plus\p@ \@minus2\p@
+ \def\@listi{\leftmargin\leftmargini
+ \topsep 3\p@ \@plus\p@ \@minus\p@
+ \parsep 2\p@ \@plus\p@ \@minus\p@
+ \itemsep \parsep}%
+ \belowdisplayskip \abovedisplayskip
+}
+\renewcommand\footnotesize{%
+ \@setfontsize\footnotesize\@viipt\@viiipt
+ \abovedisplayskip 4\p@ \@plus2\p@ \@minus2\p@
+ \abovedisplayshortskip \z@ \@plus1\p@
+ \belowdisplayshortskip 2.5\p@ \@plus\p@ \@minus\p@
+ \def\@listi{\leftmargin\leftmargini
+ \topsep 3\p@ \@plus\p@ \@minus\p@
+ \parsep 2\p@ \@plus\p@ \@minus\p@
+ \itemsep \parsep}%
+ \belowdisplayskip \abovedisplayskip
+}
+\renewcommand\scriptsize{\@setfontsize\scriptsize\@vipt\@viipt}
+\renewcommand\tiny{\@setfontsize\tiny\@vpt\@vipt}
+\renewcommand\large{\@setfontsize\large\@xpt\@xiipt}
+\renewcommand\Large{\@setfontsize\Large\@xipt{13}}
+\renewcommand\LARGE{\@setfontsize\LARGE\@xiipt{14}}
+\renewcommand\huge{\@setfontsize\huge\@xivpt{18}}
+\renewcommand\Huge{\@setfontsize\Huge\@xviipt{22}}
+\setlength\parskip{6pt}
+\setlength\parindent\z@
+\RequirePackage{xcolor}
+\definecolor{AmnestyYellow}{RGB/cmyk}{255,255,0/0,0,1,0}
+\definecolor{AmnestyGray1}{RGB/cmyk}{228,228,228/0,0,0,15}
+\definecolor{AmnestyGray2}{RGB/cmyk}{178,178,178/0,0,0,32}
+\definecolor{AmnestyGray3}{RGB/cmyk}{118,118,118/0,0,0,64}
+\definecolor{AmnestyGray4}{RGB/cmyk}{82,82,82/0,0,0,79}
+\definecolor{AmnestyGray4}{RGB/cmyk}{37,37,37/0,0,0,97}
+\RequirePackage{soul}
+\sethlcolor{AmnestyYellow}
+\newcommand\titleimage[1]{\def\@titleimage{#1}}
+\titleimage{}
+\newcommand\titleimagecaption[1]{\def\@titleimagecaption{#1}}
+\titleimagecaption{}
+\newcommand\subtitle[1]{\def\@subtitle{#1}}
+\subtitle{}
+\newcommand\copyrightyear[1]{\def\@copyrightyear{#1}}
+\copyrightyear{\the\year}
+\newcommand\firstpublicationyear[1]{\def\@firstpublicationyear{#1}}
+\firstpublicationyear{\@copyrightyear}
+\newcommand\reportyear[1]{\def\@reportyear{#1}}
+\reportyear{\@copyrightyear}
+\newcommand\reportmonth[1]{\def\@reportmonth{#1}}
+\reportmonth{\ifcase\month\or
+ January\or February\or March\or April\or May\or June\or
+ July\or August\or September\or October\or November\or December\fi}
+\newcommand\reportindex[1]{\def\@reportindex{#1}}
+\reportindex{XXXX XX/XX/XXX}
+\newcommand\blurb[1]{\def\@blurb{#1}}
+\blurb{}
+\newcommand\frontmatter{%
+ \pagenumbering{arabic}%
+ \pagestyle{empty}}
+\renewcommand{\maketitle}{%
+ \newgeometry{top=0.55in, bottom=1.18in,
+ left=0.55in, right=0.55in, footskip=20pt}%
+ \pagestyle{titlepage}%
+ \ifx\@titleimage\@empty
+ \ClassWarningNoLine{amnestyreport}{You did not define the title
+ image}%
+ \else
+ \includegraphics[width=18.17cm]{\@titleimage}\par
+ \fi
+ \ifx\@title\@empty\else
+ {\condensed\bfseries\fontsize{48pt}{48pt}\selectfont
+ \hl{\MakeUppercase{\@title}}\par}%
+ \fi
+ \ifx\@subtitle\@empty\else
+ {\condensed\fontsize{22pt}{22pt}\selectfont
+ \MakeUppercase{\@subtitle}\par}%
+ \fi
+ \clearpage
+ \thispagestyle{backtitlepage}%
+ {\condensed\bfseries\fontsize{22pt}{22pt}\selectfont
+ \hl{Amnesty International is a movement of 10 million people
+ which mobilizes the humanity in everyone and campaigns
+ for change so we can all enjoy our human rights. Our vision
+ is of a world where those in power keep their promises,
+ respect international law and are held to account. We are
+ independent of any government, political ideology, economic
+ interest or religion and are funded mainly by our membership
+ and individual donations. We believe that acting in solidarity
+ and compassion with people everywhere can change our
+ societies for the better.}\par}
+\vfill
+\parbox[t]{0.48\textwidth}{\condensed\footnotesize
+ \textcopyright~Amnesty International~\@copyrightyear
+
+Except where otherwise noted, content in this document is licensed
+under a Creative Commons (attribution, non-commercial, no derivatives,
+international 4.0) licence.
+\url{https://creativecommons.org/licenses/by-nc-nd/4.0/legalcode}.
+
+For more information please visit the permissions page on our website:
+\href{https://www.amnesty.org}{www.amnesty.org}.
+
+Where material is attributed to a copyright owner other than Amnesty International this
+material is not subject to the Creative Commons licence.
+
+First published in \@firstpublicationyear\\
+by Amnesty International Ltd\\
+Peter Benenson House, 1 Easton Street\\
+London WC1X 0DW, UK}\hfill
+\parbox[t]{0.48\textwidth}{\condensed\footnotesize
+ \ifx\@titleimagecaption\@empty\else
+ $\leftarrow$\faEye[regular] \raggedright\itshape\textbf{Cover photo:} \@titleimagecaption\fi}
+\restoregeometry
+\pagestyle{empty}}
+
+\newcommand\mainmatter{\cleardoublepage
+ \pagestyle{main}%
+}
+\def\amnesty@logo@graphics{%
+ \ifamnesty@logo
+ \includegraphics[height=0.5in]{Amnesty_logo}%
+ \else
+ \rule{0pt}{0.5in}%
+ \fi}
+\RequirePackage{fancyhdr}
+\renewcommand{\headrulewidth}{0pt}
+\renewcommand{\footrulewidth}{0pt}
+\fancypagestyle{titlepage}{%
+ \fancyhf{}%
+ \fancyfoot[R]{\raisebox{-\height}{\amnesty@logo@graphics}}%
+}
+\fancypagestyle{backtitlepage}{%
+ \fancyhf{}%
+ \fancyfoot[L]{\bfseries Index: \@reportindex\\
+ Original language: English\\
+ \large\href{https://amnesty.org}{amnesty.org}}%
+ \fancyfoot[R]{\raisebox{-\height}{\amnesty@logo@graphics}}%
+}
+\fancypagestyle{main}{%
+ \fancyhf{}%
+ \fancyfoot[L]{\condensed\footnotesize\textbf{\MakeUppercase{\@title}}\par
+ \ifx\@subtitle\@empty\else\condensed\MakeUppercase{\@subtitle}\par\fi
+ Amnesty International
+ }%
+ \fancyfoot[R]{\normalsize\normalfont\thepage\hspace{1in}}%
+}
+\fancypagestyle{backcoverpage}{%
+ \fancyhf{}%
+ \fancyfoot[L]{\normalsize\normalfont
+ INDEX: \mbox{\@reportindex}\\
+ \MakeUppercase{\@reportmonth~\@reportyear}\\
+ LANGUAGE: ENGLISH\\
+ \LARGE\bfseries\href{https://amnesty.org}{amnesty.org}}%
+ \fancyfoot[R]{\raisebox{-\height}{\amnesty@logo@graphics}\hspace{1in}}%
+}
+\renewcommand\section{\@startsection {section}{1}{\z@}%
+ {-3.5ex \@plus -1ex \@minus -.2ex}%
+ {.5ex \@plus.2ex}%
+ {\condensed\fontsize{45pt}{45pt}\selectfont\bfseries\raggedright\MakeUppercase}}
+\renewcommand\subsection{\@startsection{subsection}{2}{\z@}%
+ {-3.25ex\@plus -1ex \@minus -.2ex}%
+ {0.5ex \@plus .2ex}%
+ {\condensed\fontsize{21pt}{21pt}\selectfont\bfseries\raggedright\MakeUppercase}}
+\renewcommand\subsubsection{\@startsection{subsubsection}{3}{\z@}%
+ {-3.25ex\@plus -1ex \@minus -.2ex}%
+ {0.5ex \@plus .2ex}%
+ {\condensed\fontsize{16pt}{16pt}\selectfont\bfseries\raggedright\MakeUppercase}}
+\renewcommand\paragraph{\@startsection{paragraph}{4}{\z@}%
+ {3.25ex \@plus1ex \@minus.2ex}%
+ {1sp}%
+ {\condensed\fontsize{11pt}{11pt}\selectfont\bfseries\raggedright\MakeUppercase}}
+\renewcommand*\l@section[2]{%
+ \ifnum \c@tocdepth >\z@
+ \addpenalty\@secpenalty
+ \addvspace{1.0em \@plus\p@}%
+ \setlength\@tempdima{1.5em}%
+ \begingroup
+ \def\numberline##1{##1~}%
+ \parindent \z@ \rightskip \@pnumwidth
+ \parfillskip -\@pnumwidth
+ \leavevmode \condensed\fontsize{11pt}{11pt}\selectfont\bfseries
+ \advance\leftskip\@tempdima
+ \hskip -\leftskip
+ \MakeUppercase{#1}\nobreak\hfil
+ \nobreak\hb@xt@\@pnumwidth{\hss #2%
+ \kern-\p@\kern\p@}\par
+ \endgroup
+ \fi}
+\renewcommand*\l@subsection[2]{%
+ \ifnum \c@tocdepth >1
+ \addvspace{0.5em \@plus\p@}%
+ \setlength\@tempdima{2em}%
+ \begingroup
+ \def\numberline##1{##1~}%
+ \parindent \z@ \rightskip \@pnumwidth
+ \parfillskip -\@pnumwidth
+ \leavevmode \condensed\fontsize{10pt}{10pt}\selectfont
+ \advance\leftskip\@tempdima
+ \hskip -\leftskip
+ \MakeUppercase{#1}\nobreak\hfil
+ \nobreak\hb@xt@\@pnumwidth{\hss #2%
+ \kern-\p@\kern\p@}\par
+ \endgroup
+ \fi}
+\renewcommand*\l@subsubsection[2]{%
+ \ifnum \c@tocdepth >2
+ \addvspace{0.5em \@plus\p@}%
+ \setlength\@tempdima{2.5em}%
+ \begingroup
+ \def\numberline##1{##1~}%
+ \parindent \z@ \rightskip \@pnumwidth
+ \parfillskip -\@pnumwidth
+ \leavevmode \condensed\fontsize{9pt}{9pt}\selectfont
+ \advance\leftskip\@tempdima
+ \hskip -\leftskip
+ \MakeUppercase{#1}\nobreak\hfil
+ \nobreak\hb@xt@\@pnumwidth{\hss #2%
+ \kern-\p@\kern\p@}\par
+ \endgroup
+ \fi}
+\RequirePackage[font=it]{caption}
+\DeclareCaptionLabelFormat{table}{$\downarrow$\faEye[regular]\itshape~
+ #1 #2}
+\DeclareCaptionLabelFormat{figure}{$\uparrow$\faEye[regular]\itshape~
+ #1 #2}
+\DeclareCaptionLabelFormat{side}{$\leftarrow$\faEye[regular]\itshape~
+ #1 #2}
+\captionsetup[table]{labelformat=table}
+\captionsetup[figure]{labelformat=figure}
+\captionsetup[SCfigure]{labelformat=side}
+\captionsetup[SCtable]{labelformat=side}
+\def\fps@figure{hb}
+\def\fps@table{hb}
+\def\fps@SCfigure{hb}
+\def\fps@SCtable{hb}
+\let\table@AI@Orig\table
+\let\endtable@AI@Orig\endtable
+\def\sideTableCaptions{%
+ \def\table{\SCtable[50]}%
+ \def\endtable{\endSCtable}}
+\def\normalTableCaptions{%
+ \def\table{\table@AI@Orig}%
+ \def\endtable{\endtable@AI@Orig}}
+\newif\if@AI@sideFigures
+\@AI@sideFiguresfalse
+\let\figure@AI@Orig\figure
+\let\endfigure@AI@Orig\endfigure
+\def\sideFigureCaptions{%
+ \@AI@sideFigurestrue
+ \def\figure{\SCfigure[50]}%
+ \def\endfigure{\endSCfigure}}
+\def\normalFigureCaptions{%
+ \@AI@sideFiguresfalse
+ \def\figure{\figure@AI@Orig}%
+ \def\endfigure{\endfigure@AI@Orig}}
+\renewcommand\@makefntext[1]{%
+ \raggedright\parindent\z@\hangindent2em%
+ \noindent
+ \@makefnmark\,#1}
+\newcommand\backmatter{%
+ \cleardoublepage
+ \thispagestyle{empty}%
+ \setbox\@tempboxa\vbox{\hsize=5in\condensed\fontsize{40pt}{40pt}\selectfont\bfseries
+ AMNESTY INTERNATIONAL
+ IS A GLOBAL MOVEMENT
+ FOR HUMAN RIGHTS.
+ WHEN INJUSTICE HAPPENS
+ TO ONE PERSON, IT
+ MATTERS TO US ALL.}%
+\textcolor{AmnestyYellow}{\rule{10pt}{\ht\@tempboxa}}\hspace{5pt}\box\@tempboxa
+\vfill
+
+\parbox[t]{0.45\textwidth}{\setlength{\parskip}{6pt}%
+ \condensed\fontsize{16pt}{16pt}\selectfont
+ CONTACT US
+
+\normalsize\normalfont
+\faEnvelope~\href{mailto:info@amnesty.org}{info@amnesty.org}
+
+\faPhone*~+44 (0)20 7413 5500}\hspace{0.05\textwidth}%
+\parbox[t]{0.45\textwidth}{\setlength{\parskip}{6pt}%
+ \condensed\fontsize{16pt}{16pt}\selectfont
+ JOIN THE CONVERSATION
+
+\normalsize\normalfont
+\faFacebook~\href{https://www.facebook.com/AmnestyGlobal}{www.facebook.com/AmnestyGlobal}
+
+\faTwitter~@Amnesty}\clearpage
+\thispagestyle{backcoverpage}%
+{\condensed\fontsize{28pt}{28pt}\bfseries\hl{\MakeUppercase{\@title}}\par}%
+\ifx\@subtitle\@empty\else
+{\condensed\fontsize{16pt}{16pt}\MakeUppercase{\@subtitle}\par}%
+\fi
+\bigskip
+\@blurb
+}
+
+\RequirePackage{longtable, booktabs}
+\newdimen\@tempdimAI
+\newenvironment{AmnestyGlossary}[1][5em]{%
+ \clearpage
+ \section*{Glossary}
+ \bgroup
+ \setlength\extrarowheight{1pt}%
+ \rowcolors{1}{AmnestyGray1}{white}%
+ \setlength\@tempdimAI{\textwidth}%
+ \addtolength\@tempdimAI{-2\tabcolsep}%
+ \addtolength\@tempdimAI{-#1}%
+ \begin{longtable}{p{#1}<{\raggedright}p{\@tempdimAI}<{\raggedright}}}{%
+ \end{longtable}\egroup}
+\renewenvironment{quote}{%
+ \def\FrameCommand{\vrule width 6pt \hspace{10pt}}%
+ \MakeFramed {\advance\hsize-\width \FrameRestore}%
+ \vskip0pt\Huge\bfseries\condensed\raggedright\strut\relax}%
+{\strut\vskip5pt\endMakeFramed}
+\def\attribution#1{\par\normalfont\mdseries\normalsize\raggedright #1}
+\def\tightlist{%
+ \setlength{\itemsep}{0pt}\setlength{\parskip}{0pt}}
+\normalsize\normalfont\raggedright
+\frontmatter
+\endinput
+%%
+%% End of file `amnestyreport.cls'.
diff --git a/Master/tlpkg/bin/tlpkg-ctan-check b/Master/tlpkg/bin/tlpkg-ctan-check
index 912d5951fe6..09417bbedb0 100755
--- a/Master/tlpkg/bin/tlpkg-ctan-check
+++ b/Master/tlpkg/bin/tlpkg-ctan-check
@@ -38,7 +38,7 @@ my @TLP_working = qw(
aligned-overset
alkalami allrunes almendra almfixed alnumsec
alpha-persian alphalph
- alterqcm altfont altsubsup amiri amiweb2c-guide
+ alterqcm altfont altsubsup amiri amiweb2c-guide amnestyreport
amsaddr amscdx amscls amscls-doc amsfonts amslatex-primer
amsldoc-it amsldoc-vn
amsmath amsmath-it amsrefs amstex amsthdoc-it
diff --git a/Master/tlpkg/tlpsrc/amnestyreport.tlpsrc b/Master/tlpkg/tlpsrc/amnestyreport.tlpsrc
new file mode 100644
index 00000000000..e69de29bb2d
--- /dev/null
+++ b/Master/tlpkg/tlpsrc/amnestyreport.tlpsrc
diff --git a/Master/tlpkg/tlpsrc/collection-publishers.tlpsrc b/Master/tlpkg/tlpsrc/collection-publishers.tlpsrc
index 7b299d056cb..3d0ca12bfe2 100644
--- a/Master/tlpkg/tlpsrc/collection-publishers.tlpsrc
+++ b/Master/tlpkg/tlpsrc/collection-publishers.tlpsrc
@@ -15,6 +15,7 @@ depend afparticle
depend afthesis
depend aguplus
depend aiaa
+depend amnestyreport
depend anonymous-acm
depend anufinalexam
depend aomart