shared-prefacio.adoc 3.79 KB
Newer Older
1
2
3
4
5
[[prefacio]]
[preface]
== Prefácio

:cap: prefacio
6
7
:online: {gitrepo}/blob/{edition}/livro/capitulos/code/{cap}
:local: code/{cap}
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

.Baixando a versão mais nova deste livro
____
Acesse {gitrepo}/releases para verificar se há uma versão mais
nova deste livro (versão atual: *{edition}*). Você pode consultar
o Histórico de revisões, na início do livro, para verificar o que mudou
entre uma versão e outra.
____


include::prefacio.adoc[]

[[caixas_de_dialogo]]
=== Caixas de diálogo

Nesta seção apresentamos as caixas de diálogo que poderão ser 
utilizadas durante o texto. Confira os significados delas.

[NOTE]
========
Esta caixa é utilizada para realizar alguma reflexão.
========

[TIP]
========
Esta caixa é utilizada quando desejamos remeter a materiais complementares.
========

[IMPORTANT]
========
Esta caixa é utilizada para chamar atenção sobre algo importante.
========

[CAUTION]
========
Esta caixa é utilizada para alertar sobre algo que exige cautela.
========

[WARNING]
========
Esta caixa é utilizada para alertar sobre algo potencialmente perigoso.
========

Os significados das caixas são apenas uma referência, podendo ser adaptados 
conforme as intenções dos autores.

=== Vídeos

Os vídeos são apresentados da seguinte forma:

.Como baixar os códigos fontes: http://youtu.be/Od90rVXJV78
["qrcode", size=10, scaledwidth="30%"]
----
http://youtu.be/Od90rVXJV78
----

[NOTE]
====
Na *versão impressa* irá aparecer uma imagem quadriculada. Isto é o
qrcode (http://pt.wikipedia.org/wiki/C%C3%B3digo_QR) contendo o link
do vídeo.  Caso você tenha um celular com acesso a internet poderá
acionar um programa de leitura de qrcode para acessar o vídeo.

Na *versão digital* você poderá assistir o vídeo clicando diretamente
sobre o link.
====

=== Compreendendo as referências

As referências são apresentadas conforme o elemento que está sendo referenciado:

Referências a capítulos:: <<prefacio>>

Referências a seções:: <<como_estudar>>, <<caixas_de_dialogo>>.

Referências a imagens:: <<fig_issue_contribuicao>>

NOTE: Na *versão impressa*, o número que aparece entre chaves ``[ ]'' 
corresponde ao número da página onde está o conteúdo referenciado. Na 
*versão digital* do livro você poderá clicar no link da referência.

ifdef::prefacio-code[]
=== Códigos e comandos

Os códigos ou comandos são apresentados com a seguinte formação:

 echo "Hello Word"

No exemplo a seguir, temos outra apresentação de código fonte. Desta
vez de um arquivo _{prefacio-code}_, que se encontra dentro do diretório
_livro/capitulos/code/{cap}_.  O diretório _{cap}_ indica o capítulo
onde o código está relacionado.

101
102
:srcfile: {prefacio-code}

103
.Código fonte
104
{online}/{srcfile}[{local}/{srcfile}]
105

106
.{srcfile}
107
----
108
include::{local}/{srcfile}[]
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
----

[[sec_codigo_fonte]]
=== Baixando os códigos fontes

Recomendamos duas formas de acessar os códigos fontes contidos neste livro:

Acesso on-line individual::
{gitrepo}/tree/{edition}/livro/capitulos/code

Baixando zip contendo os códigos::

Versão atual::: {gitrepo}/archive/{edition}.zip

NOTE: Independente do método utilizado para acessar os arquivos, os códigos
fontes estão organizados por capítulos no diretório `livro/capitulos/code`.

endif::prefacio-code[]


[[sec_feedback]]
=== Feedback

Você pode contribuir com a atualização e correção deste livro. Ao
final de cada capítulo você será convidado a fazê-lo, enviando
um feedback como a seguir:

include::feedback.adoc[]

NOTE: A seção sobre o feedback, no guia do curso, pode ser acessado
em: https://github.com/edusantana/guia-geral-ead-computacao-ufpb/blob/master/livro/capitulos/livros-contribuicao.adoc.

[[fig_issue_contribuicao]]
.Exemplo de contribuição
image::images/prefacio/issue.eps[scaledwidth="70%"]

////
Sempre terminar o arquivo com uma nova linha.
////