summaryrefslogtreecommitdiff
path: root/Master/texmf-dist/doc
diff options
context:
space:
mode:
authorKarl Berry <karl@freefriends.org>2021-04-18 20:21:39 +0000
committerKarl Berry <karl@freefriends.org>2021-04-18 20:21:39 +0000
commitb3b353ffa73411314302bcc58efcaf0a83560249 (patch)
tree17a316cb3f3ba4f773e3831de4279b9005b52b04 /Master/texmf-dist/doc
parentcba1452149ffb9bb0f7422999f79ddc02e58a43e (diff)
huawei (18apr21)
git-svn-id: svn://tug.org/texlive/trunk@58907 c570f23f-e606-0410-a88d-b1316a301751
Diffstat (limited to 'Master/texmf-dist/doc')
-rw-r--r--Master/texmf-dist/doc/latex/huawei/README.md29
-rw-r--r--Master/texmf-dist/doc/latex/huawei/huawei.pdfbin0 -> 362777 bytes
-rw-r--r--Master/texmf-dist/doc/latex/huawei/huawei.tex223
3 files changed, 252 insertions, 0 deletions
diff --git a/Master/texmf-dist/doc/latex/huawei/README.md b/Master/texmf-dist/doc/latex/huawei/README.md
new file mode 100644
index 00000000000..ddb9d7db340
--- /dev/null
+++ b/Master/texmf-dist/doc/latex/huawei/README.md
@@ -0,0 +1,29 @@
+Disclaimer: This is **NOT** a product of Huawei Technologies Co., Ltd.
+This package is created in order to help some people working
+with Huawei or inside Huawei to render some documents in LaTeX format.
+You are welcome to use it at your own risk.
+
+You can use this [`huawei.cls`](huawei.cls) LaTeX style just by copying it to some local
+directory and then mentioning it in the preamble of all your documents
+(on my laptop it's called `/code/huawei.cls`):
+
+```tex
+\documentclass[landscape]{/code/huawei}
+\author{Yegor Bugayenko}
+\title{An Interesting Document About Something}
+\begin{document}
+Hello, world!
+\end{document}
+```
+
+Find more examples in the [`samples/`](/samples) directory.
+
+If you need more formatting options,
+[submit an issue](https://github.com/cqfn/huawei-latex/issues),
+I'll implement them.
+
+If you want to contribute yourself, make a fork, then create a branch,
+then run `make` in the root directory.
+It should compile everything without errors. If not, submit an issue and wait.
+Otherwise, make your changes and then run `make` again. If the build is
+still clean, submit a pull request.
diff --git a/Master/texmf-dist/doc/latex/huawei/huawei.pdf b/Master/texmf-dist/doc/latex/huawei/huawei.pdf
new file mode 100644
index 00000000000..d0341ad5615
--- /dev/null
+++ b/Master/texmf-dist/doc/latex/huawei/huawei.pdf
Binary files differ
diff --git a/Master/texmf-dist/doc/latex/huawei/huawei.tex b/Master/texmf-dist/doc/latex/huawei/huawei.tex
new file mode 100644
index 00000000000..adacc3b0928
--- /dev/null
+++ b/Master/texmf-dist/doc/latex/huawei/huawei.tex
@@ -0,0 +1,223 @@
+\documentclass[nobrand,nosecurity]{./huawei}
+\renewcommand*\thetitle{\LaTeX{} Class \ff{huawei}}
+\renewcommand*\thesubtitle{User's Guide}
+\renewcommand*\theauthor{\nospell{Yegor Bugayenko}}
+\begin{document}
+\maketitle
+
+\ff{Version 0.1.0}
+
+\section{Overview}
+
+The provided class \ff{huawei} helps you design your work
+documents and presentations keeping the code short and the
+style elegant enough both for management and technical
+papers. To use the class you simply mention its name
+in the preamble:
+
+\begin{minted}{text}
+\documentclass{huawei}
+\begin{document}
+Hello, world!
+\end{document}
+\end{minted}
+
+The document rendered from this \LaTeX{} code will look similar
+to the document you are reading now. We recommend you to use
+\ff{latexmk} to compile your \ff{.tex} files to \ff{.pdf}.
+The simplest setup will require a few files staying next to your
+\ff{.tex} file, in the same directory (``story'' is the name
+of your project here):
+
+\begin{minted}{text}
+story\
+ .latexmkrc
+ .gitignore
+ Makefile
+ story.tex
+\end{minted}
+
+The content of your \ff{.latexmkrc} file would be this:
+
+\begin{minted}{text}
+$pdflatex = 'pdflatex %O --shell-escape %S';
+\end{minted}
+
+Make sure the \ff{.gitignore} file lists all the files generated
+by \ff{pdflatex} during the compilation. You don't need to commit
+them to your repository, since they are temporary and will
+be generated again when you compile your document.
+
+The recommended content of the \ff{Makefile} would be this:
+
+\begin{minted}{text}
+TEXS=$(wildcard *.tex)
+PDFS=$(TEXS:.tex=.pdf)
+all: $(PDFS)
+%.pdf: %.tex
+ latexmk -pdf $<
+\end{minted}
+
+In order to compile the document, just say \ff{make} on the command line.
+
+\section{Layout Options}
+
+There are a few class options, provided in square brackets after the
+\ff{\textbackslash{}documentclass}, which can help you fine-tune
+the layout of your document:
+
+\ff{landscape}
+ makes the document in landscape format, also changing the size
+ of the paper to 16x9 inches (the default page size is
+ \href{https://en.wikipedia.org/wiki/Paper_size}{A4}),
+ making it perfect for presentations.
+
+\ff{anonymous}
+ removes the name of the author everywhere, including the bottom
+ of the page, where the author's name stays next to the name of the
+ company.
+
+\ff{nobrand}
+ avoid mentioning the brand of Huawei anywhere
+ in the document and removes the logo too.
+
+\ff{nosecurity}
+ avoids mentioning the level of security at the right top
+ corner of the document and also avoids showing the ID of the author
+ where it usually is visible.
+
+\ff{nodate}
+ don't show the date and time at the bottom of each page,
+ where they usually are rendered in ISO~8601 format.
+
+\ff{nopaging}
+ avoids page numbers at the bottom of each page.
+
+\section{Preamble}
+
+In the preamble you can specify meta information about the document,
+such as its title or author's name, here is how:
+
+\begin{minted}{text}
+\documentclass{huawei}
+\renewcommand*\thetitle{Making Compression 15% Faster}
+\renewcommand*\thesubtitle{Technical Report}
+\renewcommand*\theauthor{Yegor Bugayenko}
+\begin{document}
+\maketitle
+Hello, world!
+\end{document}
+\end{minted}
+
+It's recommended to use \ff{\textbackslash{}renewcommand*} instead of
+\ff{\textbackslash{}renewcommand} in order to let \LaTeX{} catch you
+if by mistake a new line gets into the content.
+
+The following meta commands are defined:
+
+\ff{\textbackslash{}thetitle} is the main title of the document
+ to be used in the text and in the properties of the PDF document.
+
+\ff{\textbackslash{}thesubtitle} is the subtitle to be
+ printed under the title.
+
+\ff{\textbackslash{}theauthor} is the author of the document
+ in ``first-name last-name'' format.
+
+\ff{\textbackslash{}theid} is the internal ID of the author, if
+ it's applicable.
+
+\ff{\textbackslash{}thesecurity} is the level of security of
+ the document, which is usually printed at the top right
+ corner of it; usual values are ``Internal,''
+ ''Confidential,'' or ``Secret.''
+
+Default values of all these commands are empty. If you don't
+renew them in your document, nothing will be printed.
+
+\section{Custom Commands}
+
+There is a number of supplementary commands for better text formatting,
+which we introduced:
+
+\ff{\textbackslash{}ff\{text\}}
+ makes the text fixed-font with a nice border around.
+
+\ff{\textbackslash{}tbd\{text\}}
+ highlights the text, which is expected to be improved later
+ (tbd stands for ``To Be Determined''), like \tbd{this one}.
+
+Inside the document body you can use these commands:
+
+\ff{\textbackslash{}PrintFirstPage\{front-image\}}
+ prints the first page of a project charter or a similar landscape documents,
+ placing the image \ff{front-image.pdf} on the front (the file should be present
+ in the current dir. If you don't have the front image file, just leave
+ the first argument empty.
+
+\ff{\textbackslash{}PrintLastPage\{\}}
+ prints the last page of a project charter or a similar landscape document.
+
+\ff{\textbackslash{}PrintThankYouPage\{\}}
+ prints the last page with a "Thank You" message in the center.
+
+\ff{\textbackslash{}PrintDisclaimer\{\}}
+ prints a paragraph at the bottom of the page with a standard disclaimer.
+
+\section{Best Practices}
+
+You are free to design your documents any way you want. However,
+it would be convenient for yourself and for your readers, if you follow
+the convention we have for business and technical documents.
+The \ff{samples} directory contains a number of sample documents, which
+we suggest you to use as templates when you start making new documents.
+
+The rule of thumb is simple: try \emph{not} to format your documents.
+Instead, let the class designed by us do this work for you. Just type
+the content without changing the layout, adding colors, changing fonts,
+etc. The less you modify the look-and-feel, the better your documents
+will be perceived by your readers.
+
+\subsection{Two Columns}
+
+In the landscape format it's recommended to use two columns, for better
+readability of the text. Here is how:
+
+\begin{minted}{text}
+\documentclass{huawei}
+\begin{document}
+\newpage
+\begin{multicols}{2}
+\section*{First}
+Here goes the first column content.
+\columnbreak
+\section*{Second}
+Here goes the second column content.
+\end{multicols}
+\end{document}
+\end{minted}
+
+A more complete example is in the\ff{samples/charter.tex}.
+
+\subsection{Crumbs}
+
+When you need to put many small information pieces into one page,
+we recommend you to use ``crumbs'':
+
+\begin{minted}{text}
+\documentclass{huawei}
+\begin{document}
+\newpage
+\section*{Project Details}
+\begin{multicols}{2}
+\raggedright
+\crumb{Budget}{\$100K}
+
+\crumb{Duration}{5 months}
+\end{multicols}
+\end{document}
+\end{minted}
+
+A more complete example is in the\ff{samples/charter.tex}.
+
+\end{document} \ No newline at end of file