summaryrefslogtreecommitdiff
path: root/Master/texmf-dist/doc/latex/abntex2/README
blob: b59e83b3c15444e5745d99e9009013a0700e2d10 (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

                            abnTeX2  
                Type­set technical and scientific 
             Brazilian documents based on ABNT rules
             
-----------------------------------------------------------------

This is the README file for abntex2 class and abntex2cite package. 
Please read the license information at the end of this file.

The abntex2 class and the abntex2cite package are intended to 
assist the preparation of technical and scientific documents 
(like thesis, articles, research projects and other 
academic papers) based on ABNT (Associação Brasileira de Normas 
Técnicas) rules used in Brazil.

The latest version of abnTeX2 is v-1.4.

SUMMARY
-----------------------------------------------------------------

  This file consists of the following sections:
  
  . Change history
  . Installation
  . Documentation
  . Copying and modification
  . Help

CHANGE HISTORY
-----------------------------------------------------------------
  2013/02/04 - v1.4
    added \partanexos and \partapendices macros as a replacement to \appendixpage
    changed all models to use new  \partanexos and \partapendices macros
    bug fix on abntex2cite.sty: incorrect use of setspace
    general review of all examples
    updated abntex2-modelo-include-comandos:
     . added section about UTF-8
    updated abntex2.tex documentation:
     . added enumitem's reference in "Alíneas e subalíneas" section
     . added section about UTF-8
     . added sections about the main options of the class
     . added  \partanexos and \partapendices explanations
     . general review
    removed change logs from example files 
    changed README file structure
  
  2013/01/18 - v1.3
    added two new model: 
      . abntex2-modelo-relatorio-tecnico.tex: Technical report in compliance to ABNT NBR 10719:2011
      . abntex2-modelo-projeto-pesquisa.tex: Research project in compliance to ABNT NBR 15287:2011
    added on abntex.tex:
      . explanations about heading (not) created by \chapter* 
      . explanations about font and XeLaTeX
    added versions numbers in all files, documents and examples with a new build.sh script
    changed default font on examples and documentations to Latin Modern (lmodern)
    changed \pretextualchapter to change headings with the value of chapter title
    changed \ABNTEXchapterfont: now it uses a font style without serif (\sffamily)
    changed thesis model to add examples of \chapter*[heading title]{text title}
    changed title of the article model from "Modelo Canônico de Artigos Acadêmicos" 
      to "Modelo Canônico de Artigo Científico"
    changed title of the thesis model from "Modelo Canônico de Trabalhos Acadêmicos" 
      to "Modelo Canônico de Trabalho Acadêmico"
    changed title of abntex2 documentation from "A classe abntex2: Modelo canônico de
      trabalhos acadêmicos brasileiros compatível com as normas ABNT NBR 14724:2011,
      ABNT NBR 6024:2012 e outras" to "A classe abntex2: Documentos técnicos e científicos 
      brasileiros compatíveis com as normas ABNT"   
    as an example of \include, now all example documents share a single file 
      named abntex2-modelo-include-comandos.tex, that has the content from
      abntex2-modelo-trabalho-academico.tex and:
       . explanations about \include and \input macros
       . explanations about compiling LaTeX documents
    bug fix: singlespace on references produced by abntex2cite.sty
    bug fix: general orthographic errors

  2013/01/13 - v1.2.1
     added length \ABNTEXcitacaorecuo, useful on articles
     abntex2's twocolumn class option changes \ABNTEXcitacaorecuo to 1.8cm 
     changed \ABNTEXcitacaorecuo explanation on abntex2.tex and on examples 
     
  2013/01/12 - v1.2
     added article support to abntex2.cls
     added new article example
     changed canonical example: new commands, explanations and examples
     changed abntex2-modelo.tex file name to abntex2-modelo-trabalho-academico.tex 
     updated documentation 
     bug fixes on abntex2.cls
     added compatibility information to:
       . ABNT NBR 10719:2011: Informação e documentação - Relatório técnico e/ou científico - Apresentação
       . ABNT NBR 15287:2011: Informação e documentação - Projeto de pesquisa - Apresentação
       . ABNT NBR 6022-2003 - Informação e documentação - Artigo em publicação periódica científica impressa - Apresentação

  2013/01/05 - v1.1
     bug fixes on abnex2cite.sty when using with Beamer 
     changed \titulo, \autor and \data to do the same as \title, \author and \date  
      
  2012/12/20 - v1.0 
     initial release on CTAN 

INSTALLATION
-----------------------------------------------------------------

In order to install the abntex2 class and abntex2cite package you need:

  abntex2.cls						The abntex2 class file.
  abntex2cite.sty					The abntex2cite citation package file.
  abntex2abrev.sty					Extension of abntex2cite package. It contains abbreviations helpers macros.
  abntex2-alf.bst					Numeric citation style file.
  abntex2-num.bst					Alphanumeric (author-date) citation style file.
  abntex2-options.bib				Default citation options configurations.
  
Put those files somewhere LaTeX can find them. Read the documentation of 
your LaTeX system to find out where this might be. 
  
If you're new to this, see https://code.google.com/p/abntex2/wiki/Instalacao (portuguese)
or http://www.tex.ac.uk/cgi-bin/texfaq2html?label=instpackages (english) for more
information on installing packages.
  

DOCUMENTATION
-----------------------------------------------------------------

The abnTeX2 documentation consists of the following files:

  README								Instructions on installation and documentation.
  abntex2-modelo-trabalho-academico.tex	An usage example of abntex2 class and abntex2cite package producing a thesis
  abntex2-modelo-relatorio-tecnico.tex	An usage example of abntex2 class and abntex2cite package producing a technical report
  abntex2-modelo-projeto-pesquisa.tex	An usage example of abntex2 class and abntex2cite package producing a research project
  abntex2-modelo-artigo.tex				An usage example of abntex2 class and abntex2cite package producing an article
  abntex2-modelo-include-comandos.tex	LaTeX examples shared by others files 
  abntex2-img-grafico.pdf				Image used as an example
  abntex2-modelo-references.bib			Bib references of examples above

  abntex2.tex							The main class documentation
  abntex2cite.tex						The abntex2cite package documentation
  abntex2cite-alf.tex					Additional alphanumeric (author-date) citation style documentation
  abntex2-doc.bib						Bib references used by documentation
  abntex2-doc-abnt-10520-2001.bib		Specific ABNT NBR 10520:2001 bib references entries
  abntex2-doc-abnt-10520-2002.bib		Specific ABNT NBR 10520:2002 bib references entries
  abntex2-doc-abnt-6023-2000.bib		Specific ABNT NBR 6023:200 bib references entries
  abntex2-doc-options.bib				Options configurations used by documentation
  abntex2-doc-test.bib					General bib references used by accordance tests

To produce any documentation above you also need:
  ltxdoc.cls   													(part of the standard LaTeX2e distribution)
  all installation files described in "INSTALLATION" section	(par of this bundle)

Compile the documentation as the example below. There are 3 PDF files of documentation and 4 of examples.
  
  pdflatex FILE.tex
  bibtex FILE.aux
  makeindex FILE
  latex2pdf FILE.tex
  latex2pdf FILE.tex
  
  (the "FILE" entry is one of the .tex file listed above)
  

COPYING AND MODIFICATION
-----------------------------------------------------------------

Copyright 2001-2003 abnTeX group at http://abntex.codigolivre.org.br
Copyright 2012-2013 abntex2 team at https://abntex2.googlecode.com/

This package can be redistributed and/or modified under the terms
of the LaTeX Project Public License distributed from CTAN
archives in the directory macros/latex/base/lppl.txt; either
version 1.3 of the license, or (at your option) any later version.

Universities and other institutions are encouraged to customize 
front pages and others files and redistribute them to the users, 
but not to change the abnTeX2 files. You may customize almost all 
abnTeX2 commands with \renewcommand or using commands from memoir 
class. It is better than changing the files themselves.

HELP
-----------------------------------------------------------------

You can get help here:
 
www   https://abntex2.googlecode.com/
group http://groups.google.com/group/abntex2

We need your help too. Access the project's home page and contact us.

Lauro César Araujo - laurocesar at laurocesar dot com