-
Notifications
You must be signed in to change notification settings - Fork 0
/
Copy pathestrutura.html
374 lines (297 loc) · 13.7 KB
/
estrutura.html
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
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
360
361
362
363
364
365
366
367
368
369
370
371
372
373
374
<!doctype html>
<html lang="pt">
<head>
<meta http-equiv="x-ua-compatible" content="ie=edge">
<meta charset="utf-8">
<meta name="viewport" content="width=device-width,initial-scale=1">
<title>HTMLy CMS em Língua Portuguesa | Estrutura</title>
<meta name="description" content="Estrutura referente ao HTMLy CMS para lusófonos">
<meta name="author" content="Fabiano Santos - @fabianosantosnet">
<meta property="og:locale" content="pt, pt_BR, pt_PT">
<meta property="og:type" content="website">
<meta property="og:title" content="Estrutura do HTMLy CMS em Língua Portuguesa">
<meta property="og:site_name" content="HTMLyCMS">
<meta property="og:description" content="Estrutura do HTMLy CMS para lusófonos">
<meta property="og:url" content="https://fabianosantosnet.github.io/HTMLyCMS/estrutura.html">
<meta property="og:image" content="https://fabianosantosnet.github.io/HTMLyCMS/assets/img/logo-htmly-cms-fb.png">
<meta property="og:image:width" content="1200">
<meta property="og:image:height" content="630">
<meta name="twitter:card" content="summary_large_image">
<meta name="twitter:creator" content="@fabianosantos_n">
<meta name="twitter:image" content="https://fabianosantosnet.github.io/HTMLyCMS/assets/img/logo-htmly-cms-tw.png">
<link rel="shortcut icon" type="image/png" href="assets/img/favicon.png">
<link rel="canonical" href="https://fabianosantosnet.github.io/HTMLyCMS/estrutura.html">
<link rel="stylesheet" href="assets/styles.css">
<script src="assets/scripts.js" defer></script>
</head>
<body>
<div class="parent">
<div class="top">
<header>
<h1><a href="https://fabianosantosnet.github.io/HTMLyCMS/">HTMLy CMS</a></h1>
<p>Sua fonte de referencia sobre o CMS no idioma português</p>
<p class="view"><a href="https://github.com/fabianosantosnet/HTMLyCMS/">GitHub deste site</a></p>
</header>
</div>
<div class="menu">
<ul>
<li><a href="./index.html"><i class="fa fa-home"></i>Principal</a></li>
<li><a href="./historico.html"><i class="fa fa-link"></i>Histórico</a></li>
<li><a href="./instalacao.html"><i class="fa fa-link"></i>Instalação</a></li>
<li><a href="./estrutura.html" class="active"><i class="fa fa-link"></i>Estrutura</a></li>
<li><a href="./dicas-e-outros.html"><i class="fa fa-link"></i>Dicas</a></li>
<li><a href="./temas.html"><i class="fa fa-link"></i>Temas</a></li>
<li><a href="./extensoes.html"><i class="fa fa-link"></i>Extensões</a></li>
</ul>
<form id="oflinks"><!-- dinamic links --></form>
</div>
<main>
<h2>HTMLy CMS em Língua Portuguesa | Estrutura</h2>
<section class="f">
<h3><i class="fa fa-folder-open-o"></i> Organização do HTMLy CMS</h3>
<p>Basicamente as tecnologias utilizadas no CMS são: arquivos JSON, HTML, CSS, JavaScript e PHP e texto com MarkDown (MD).</p>
<div class="decor"></div>
<h4>Fluxo de carregamento do sistema</h4>
<code class="minilight">/config/config.ini
/system/vendor/autoload.php
/system/htmly.php
</code><br>
<h4>Estrutura dos diretórios</h4>
<code class="minilight">
/ <-- Diretório raiz. Arquivos PHP de inicialização do sistema.
index.php
install.php
upload.php
...
/backup <-- Contém os backups com formato htmly_datadecriacao.zip
/cache <-- Contém informações do cache
downloadInfo.json
installedVersion.json
/index
index-author.txt
index-category.txt
index-page.txt
index-sorted.txt
index-sub-page.txt
index-unsorted.txt
/page
/widget
category.list.cache
/config <-- Apresenta as configurações
config.ini.example <-- Modelo de configuração geral do site (titulo do blog, tema, idioma e mais)
O arquivo do site é criado pelo "install.php", caso necessário use o método crie manual
/users <-- Contém os usuarios utilizados para administrar o CMS
username.ini.example <-- Arquivo padrão para criação de usuarios
copie e renomeie para "nomedousuario.ini" - exemplo jose.ini para o usuário jose
depois altere a senha na linha 'password = yourpassword'
para permissão de acesso também há a linha 'role = admin'
/content <-- Apresenta todo conteúdo do site
/data <-- Contem arquivo de configuração
configList.json <-- Chaves do arquivo de configuração
menu.json <-- Inclui os dados gerados através do Editor de menu
views.json <-- Lista dos nomes das postagens
tags.lang <-- Tags
/category <-- Guarda as informações das categorias
nome-categoria.md
...
/images <-- Contém as imagens carregadas através do Editor
/usuario <-- Nome do usuario (autor)
/blog <-- Tipo de site
/categoria-nome <-- pasta com o nome categoria criada (podendo ter varias)
/post <-- pasta do tipo de conteúdo (nesse caso Postagem padrão)
xxxx.md <-- Arquivo na extensão .md (MarkDown) com o formato
yyyy-mm-dd-hh-mm-ss_nometag1,nometag2_nome-artigo.md (isto é ano-mes-dia-hora-minuto-segundo_nomet***.md)
/audio <-- pasta do tipo de conteúdo (nesse caso Postagem com audio)
/image <-- pasta de artigos com tipo Postagem com imagem
/link <-- pasta de artigos com tipo Postagem de link
/quote <-- pasta de artigos com tipo Postagem com citação
/video <-- pasta de artigos com tipo Postagem com video
/draft <-- pasta com postagem em rascunho
/static <-- Pasta com páginas estáticas (formato nomedapagina.md)
sobre.md <-- Exemplo de pagina estática
contato.md <-- Exemplo de pagina estática
nome-pagina-pai.md <-- Página estática com página filha (tanto o arquivo quanto a pasta tem o mesmo nome)
/nome-pagina-pai
nomepaginafilha.md
/lang <-- Apresenta arquivos .ini de idioma a nível de CMS
en_US.ini <-- Para o idioma inglês
pt_BR.ini <-- Para o idioma português
...
/system <-- Contém arquivos do funcionamento do CMS
htmly.php <-- Arquivo contendo diversas funções de rotas (controller)
/admin <-- Incluir tema e funções do painel de administração
admin.php
/editor
LICENSE.txt
package.json
/css
editor.css
/img
wmd-buttons.png
/js
editor.js
jquery.ajaxfileupload.js
Markdown.Converter.js
Markdown.Editor.js
Markdown.Extra.js
Markdown.Sanitizer.js
node-pagedown-extra.js
node-pagedown.js
/local
Markdown.local.fr.js
/views
404.html.php
add-content.html.php
add-page.html.php
backup.html.php
backup-start.html.php
categories.html.php
category-list.html.php
clear-cache.html.php
config-custom.html.php
config.html.php
config-metatags.html.php
config-performance.html.php
config-reading.html.php
config-widget.html.php
content-type.html.php
delete-category.html.php
delete-page.html.php
delete-post.html.php
denied.html.php
edit-content.html.php
edit-page.html.php
import.html.php
layout.html.php
login.html.php
logout.html.php
main.html.php
menu.html.php
no-posts.html.php
popular-posts.html.php
posts-list.html.php
static-pages.html.php
updated-to.html.php
update.html.php
user-draft.html.php
user-posts.html.php
/includes <-- Diversos arquivos essenciais
dispatch.php
functions.php
opml.php
session.php
/plugins <-- Pasta destinadas aos plugins do sistema
/resources <-- São recursos simples do CMS
readme.txt
/css
adminlte.min.css
font-awesome.css
jquery-ui.css
toolbar.css
/fonts
FontAwesome.otf
fontawesome-webfont.eot
fontawesome-webfont.svg
fontawesome-webfont.ttf
fontawesome-webfont.woff
fontawesome-webfont.woff2
glyphicons-halflings-regular.eot
glyphicons-halflings-regular.svg
glyphicons-halflings-regular.ttf
glyphicons-halflings-regular.woff
/images
logo-small.png
logo-big.png
/jquery-ui
ui-icons_444444_256x240.png
ui-icons_555555_256x240.png
ui-icons_777620_256x240.png
ui-icons_777777_256x240.png
ui-icons_cc0000_256x240.png
ui-icons_ffffff_256x240.png
/js
adminlte.min.js
bootstrap.min.js
jquery.min.js
jquery.nestable++.js
jquery.nestable.js
jquery-ui.min.js
/upgrade <-- Arquivos referente a atualização do CMS
index.php
run.php
/vendor <-- Conjunto de recursos criados por terceiros utilizados no CMS
autoload.php
/composer
/ircmaxell
/password-compat
/jbroadway
/urlify
/kanti
/hub-updater
/michelf
/php-markdown
/suin
/php-rss-writer
/themes <-- Local para colocar as pastas dos temas do site/blog
</code>
<section class="f">
<h4><i class="fa fa-pencil"></i> Edição de arquivos manualmente</h4>
<p>Conheça a estrutura dos arquivos:</p>
<p><code class="c">/username/blog/category/<span>type</span>/</code> - ao qual o <em>type</em> pode ser: post, video, audio, link e quote.</p>
<ul>
<li><b>username</b> deve ser o mesmo de <code class="p">config/users/<span>username</span>.ini</code></li>
<li><b>category</b> deve corresponder a category.md dentro de <code class="p">content/data/category/<span>category.md</span></code> exceto a categoria uncategorized (não categorizada - não precisa estar nessa pasta)</li>
</ul>
<p>Para páginas estáticas envie os arquivos para <code class="p">/content/static</code>:</p>
<ul>
<li>ao criar a página 'sobre' <code class="c">/content/static/<span>sobre.md</span></code> - gera a url <code class="p">https://seuSite.com.br/<strong>sobre</strong></code></li>
<li>para sub-páginas <code class="c">/content/static/sobre/<span>equipe.md</span></code> - gera a url <code class="p">https://seuSite.com.br/<strong>sobre/equipe</strong></code></li>
</ul>
<h5><i class="fa fa-file-o"></i> Nome de arquivo</h5>
<p>Quando você cria um post pelo painel de controle é criado um arquivo com o padrão:</p>
<p><code class="p"><span>2021-03-16-10-32-40_tag1,tag2,tag3_nome-do-artigo.md</span></code></p>
<p>Explicação (separada pelo sublinhado):</p>
<ul>
<li><code class="p">2021-03-16</code> é a data da criação da postagem no formato <code class="c">yyyy-mm-dd-hh-mm-ss</code>;</li>
<li><code class="p">tag1,tag2,tag3</code> são as tags relacionadas ao artigo/post separadas por vigula quando há mais de uma;</li>
<li><code class="p">nome-do-artigo</code> representa a URL.</li>
</ul>
<h5><i class="fa fa-file-o"></i> Meta tags de conteúdo</h5>
<p>Para edição de arquivo manual você precisa criar as tags:</p>
<p>Defina o título entre os 't'<br><code class="p"><span><!--t</span> Título <span>t--></span></code></p>
<p>Coloque a descrição entre os 'd'<br><code class="p"><span><!--d</span> Descrição <span>d--></span></code></p>
<p>Escreva o nome das tags relacionadas entre 'tag' de início e fim<br><code class="p"><span><!--tag</span> tag01,tag02,tag03,tag04,tag05 <span>tag--></span></code></p>
<p>Postagem com imagem em destaque entre os 'image'<br><code class="p"><span><!--image</span> http://www.example.com/image-url/image.jpg <span>image--></span></code></p>
<p>Postagem de vídeo do Youtube em destaque entre os 'video'<br><code class="p"><span><!--video</span> ´https://www.youtube.com/watch?v=xxxxxxx <span>video--></span></code></p>
<p>Postagem com áudio do SoundCloud em destaque entre os 'audio'<br><code class="p"><span><!--audio</span> ´https://soundcloud.com/xxxx/audio-url <span>audio--></span></code></p>
<p>Postagem de link em destaque entre os 'link'<br><code class="p"><span><!--link</span> https://linkdoartigodestacado.com.br <span>link--></span></code></p>
<p>Postagem de citação em destaque entre os 'quote'<br><code class="p"><span><!--quote</span> A citação é uma marca do dialogismo linguístico, feita para sustentar uma hipótese ...(Wikipedia) <span>quote--></span></code></p>
<p>Exemplo completo: <br><code class="p">
<!--t Título do artigo t-->
<!--d Descrição do artigo (resumo) d-->
<!--tag Tag1,Tag2 tag-->
<!--video https://www.youtube.com/watch?v=xxxxxxx video-->
Introducao do artigo
Desenvolvimento
Conclusao.
</code></p>
<h5><i class="fa fa-file-o"></i> Categoria</h5>
<p>Crie uma categoria, por exemplo, 'Informática' dentro de <code class="p">content/data/category/<span>informatica.md</span></code> com o conteúdo:</p>
<p><code class="p"><!--t Informatica t-->
<!--d Descrição dessa categoria d-->
Informação dessa categoria.</code></p>
<p>Para adicionar uma Postagem padrão de nome 'smartphones' na categoria 'Informatica' crie-o na seguinte estrutura: <code class="p">content/usuario/informatica/post/<span>smartphones.md</span></code> - 'post' é um dos tipos de postagem.</p><br>
</section>
</section>
</main>
<div class="bottom">
<footer>
<p>Projeto mantido por <a href="https://github.com/fabianosantosnet"><i class="fa fa-github"></i>fabianosantosnet</a><br>
<small>Hospedado no GitHub Pages — Tema criado por <a href="https://www.fabianosantos.net">fabianosantos.net</a></small></p>
<p id="contractdev"></p>
<p><small><i class="fa fa-file-text"></i> JavaScript - <i class="fa fa-css3"></i> CSS3 - <i class="fa fa-html5"></i> HTML5 - <i class="fa fa-font-awesome"></i> Fonte Awesome</small></p>
</footer>
</div>
</div>
</body>
</html>