diff options
author | Karl Berry <karl@freefriends.org> | 2021-04-18 20:21:39 +0000 |
---|---|---|
committer | Karl Berry <karl@freefriends.org> | 2021-04-18 20:21:39 +0000 |
commit | b3b353ffa73411314302bcc58efcaf0a83560249 (patch) | |
tree | 17a316cb3f3ba4f773e3831de4279b9005b52b04 /Master/texmf-dist/doc/latex | |
parent | cba1452149ffb9bb0f7422999f79ddc02e58a43e (diff) |
huawei (18apr21)
git-svn-id: svn://tug.org/texlive/trunk@58907 c570f23f-e606-0410-a88d-b1316a301751
Diffstat (limited to 'Master/texmf-dist/doc/latex')
-rw-r--r-- | Master/texmf-dist/doc/latex/huawei/README.md | 29 | ||||
-rw-r--r-- | Master/texmf-dist/doc/latex/huawei/huawei.pdf | bin | 0 -> 362777 bytes | |||
-rw-r--r-- | Master/texmf-dist/doc/latex/huawei/huawei.tex | 223 |
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 Binary files differnew file mode 100644 index 00000000000..d0341ad5615 --- /dev/null +++ b/Master/texmf-dist/doc/latex/huawei/huawei.pdf 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 |