summaryrefslogtreecommitdiff
path: root/macros/latex/contrib/ucsmonograph/README.md
blob: 066d57d604bc7768b871ed9474c5a495968eac7e (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
# ucsmonograph

**Português abaixo! ;)**

LaTeX class made for typesetting academic documents according to the ABNT (Brazillian Technical Standards Association) standards, adjusted to the requirements of the UCS (University of Caxias do Sul).

The author of this document is Henrique Baron.
Contact information:
* E-mail: henrique.baron@gmail.com
* TeX Stack Exchange profile: https://tex.stackexchange.com/users/153467/henrique-baron

## License information
Copyright 2018 Henrique Baron

This work may be distributed and/or modified under the
conditions of the LaTeX Project Public License, either version 1.3c
of this license or (at your option) any later version.
The latest version of this license is in
  http://www.latex-project.org/lppl.txt
and version 1.3c 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 Henrique Baron.

This work consists of the files ucsmonograph.dtx and ucsmonograph.ins
and the derived file ucsmonograph.cls.

## Installation
There are three possibilities for installing the `ucsmonograph` class:
you may install it directly from your MiKTeX or TeXLive distribution;
you may download the `.dtx` `.ins` installation files;
or (specially if you are using an on-line LaTeX editor) you can download the compiled `.cls` directly.

### Installing through any TeX distribution
Open your TeX distribution's package manager, search for the `ucsmonograph` class and install it.
Even simpler, if your TeX installation is configured to install packages on-the-fly, you can just call `ucsmonograph` as your document class and this class and all its dependencies will be automatically installed.

### Installing from INS and DTX files
Firstly you shall download the following files:
* ucsmonograph.dtx
* ucsmonograph.ins

Then, you may run `latex` on the INS file to make it generate the class (.cls) file:

    latex ucsmonograph.ins
    
and you can run `pdflatex` on the DTX file to generate the class documentation:

    pdflatex ucsmonograph.dtx
    
Generate the index and changelog with `makeindex` commands:

    makeindex -s gglo.ist -o ucsmonograph.gls ucsmonograph.glo
    makeindex -s gind.ist -o ucsmonograph.ind ucsmonograph.idx
    
Run `pdflatex` once again to generate the class documentation with the index and changelog:

    pdflatex ucsmonograph.dtx

The generated .CLS file shall be copied to

    TEXMF/tex/latex/ucsmonograph
    
and the .PDF documentation file shall be copied to

    TEXMF/doc/latex/ucsmonograph
    
Where `TEXMF` is your TeX root, that is, your TeX installation folder.

### Installing the CLS file
This installation option is not recommended, but if you're using an on-line TeX editor, this is the way to go.

Download the compiled files in the repository's [Release](https://github.com/HenriqueBaron/ucsmonograph/releases) page.
It is recommended to download the PDF documentation of the class too!
The downloaded CLS file can be copied directly to your on-line project.

## Change log
v1.0.0 (2018-08-04, Henrique Baron):
* Initial version

v1.1.0 (2018-08-16, Henrique Baron):
* `hyperref` package setup done automatically through macros `\autor`, 
`\titulo`, `\preambulo` etc.;
* Created macro `\palavraschave` to define the PDF keywords (for the `hyperref` package);
* PDF bookmarks are generated automatically for the lists of contents;
* `dedicatoria` formats the page entirely. No more need to have a `minipage` environment inside it;
* Corrected bug that needed the call to `glossaries-extra` package;
* Corrected spacing after chapter title;
* Enhancements in the documentation.

v1.1.1 (2018-09-18, Henrique Baron):
* Advisor's (orientador) name in the title page is now aligned to the 
middle of the page, instead of aligning to the right;
* List of symbols' title display corrected for online LaTeX editors 
(because of accents in the ''Lista de Símbolos'' title);
* `\fonte` macro redefined to align the text to the left of the 
previous tabular environment, instead of 
centering.

v1.1.2 (2018-09-28, Henrique Baron):
Fixes:
* Horizontal spacing between section number and title;
* Line spread changed to MS Word's 1.5 equivalent;
* Vertical spacing in float legends with the `\fonte` macro;
* List item alignment with `enumerate` and `itemize` environments;
* Labels for `enumerate` and `itemize` environments configured;
* Vertical spacing between references in bibliography;
* Vertical spacing after chapter and section titles;
* Vertical spacing before and after equations and floats;
* Advisor's (orientador) name removed from the approval page under the work's description;
* Contents of cover and title page in boldface;
* Paragraph first line indent.

v1.2.0 (2018-11-22, Henrique Baron):
* Added macros `\areadoconhecimento`, `\avaliadori`, `\avaliadorii`, `\avaliadorext` and `\incluirimagem`;
* Layout changes in the content generated by the `\imprimircapa`, `\imprimirfolhaderosto` and `\imprimirfolhadeaprovacao` macros;
* The `\imprimirfolhadeaprovacao` macro now takes only one mandatory argument;
* Package `\icomma` automatically included;

v1.2.1 (Henrique Baron):
* Compatibility fix due to an update of the package `enumerate`;

v1.3.0 (2019-11-07, Henrique Baron):
* Improvements on the `epigrafe` environment;
* Fix on the `\imprimirfolhaderosto` macro;
* Multi-language support for the `resumo` environment and the `\palavraschave` macro;
* Created macro `\imprimirpalavraschave`.

# ucsmonograph - Português (BR)
Esta é uma classe LaTeX para formatação de trabalhos acadêmicos segundo o Guia para Elaboração de Trabalhos Acadêmicos da Universidade de Caxias do Sul.

O autor deste código é Henrique Baron.
Informações de contato:
* E-mail: henrique.baron@gmail.com
* Perfil do TeX Stack Exchange: https://tex.stackexchange.com/users/153467/henrique-baron

## Licença
Este trabalho utiliza a LPPL, a Licença Pública do Projeto LaTeX, e deve ser distribuído sob suas condições.
A versão mais recente da licença está disponível (em inglês) em

http://www.latex-project.org/lppl.txt

Este trabalho possui o status atual de 'mantido', e o mantenedor atual é Henrique Baron.

Este trabalho consiste nos arquivos ucsmonograph.dtx, ucsmonograph.ins e no arquivo gerado ucsmonograph.cls.

## Instalação
Há três possibilidades para instalar a classe `ucsmonograph`:
você pode instalá-la diretamente pela sua distribuição MiKTeX ou TeXLive;
você pode baixar os arquivos de instalação `.dtx` e `.ins`;
ou (especialmente se você está utilizando um editor LaTeX on-line) você pode baixer o arquivo compilado `.cls` diretamente.

### Instalando por uma distribuição TeX
Abra o gerenciador de pacotes (package manager, ou console) da sua distribuição TeX, busque pela classe `ucsmonograph` e instale-a.
Mais simples ainda, se a sua instalação TeX estiver configurada para instalar pacotes on-the-fly, você pode apenas chamar a classe `ucsmonograph` como a sua document class, e a classe e todas as suas dependências serão instaladas automaticamente.

### Instalando a partir dos arquivos INS e DTX
Primeiramente você deve baixar os seguintes arquivos:
* ucsmonograph.dtx
* ucsmonograph.ins

Então, rode o comando `latex` no arquivo INS para gerar o arquivo da classe (.cls):
    
    latex ucsmonograph.ins
    
e rode o comando `pdflatex` no arquivo DTX para gerar a documentação da classe:

    pdflatex ucsmonograph.dtx
    
Gere o índice e o changelog com comandos `makeindex`:

    makeindex -s gglo.ist -o ucsmonograph.gls ucsmonograph.glo
    makeindex -s gind.ist -o ucsmonograph.ind ucsmonograph.idx
    
e execute o comando `pdflatex` mais uma vez para gerar a documentação da classe, agora com índice e changelog:

    pdflatex ucsmonograph.dtx
    
O arquivo .CLS gerado deve ser copiado para

    TEXMF/tex/latex/ucsmonograph
    
e a documentação .PDF deve ser copiada para

    TEXMF/doc/latex/ucsmonograph
    
onde `TEXMF` é a sua raiz TeX, isto é, a sua pasta de instalação do TeX.

### Instalando o arquivo CLS
Essa opção de isntalação não é recomendada, mas se você estiver utilizando um editor TeX on-line, é a opção a se tomar.

Baixe os arquivos compilados na página de [Release](https://github.com/HenriqueBaron/ucsmonograph/releases) do repositório.
É recomendável baixar a documentação em PDF da classe também!
O arquivo CLS baixado pode ser copiado diretamente para o seu projeto on-line.