As variáveis de exibição para usar no seu tema
O Axe vem com um tema pronto, chamado Panzer, que certamente não faz uso de todos os seus recursos.
Para alterá-lo, ou criar o seu próprio tema, basta criar os arquivos HTML correspondentes à estrutura do blog (veja quais são, ao final deste artigo) inserindo nele as variáveis de exibição suportadas pelo Axe, sempre declaradas em maiúsculas e cercadas por pares de sinais de percentual.
Como exemplo, veja as linhas a seguir, que mostram o trecho inicial de um cabeçalho HTML:
<pre><head>
<title>%%PAGETITLE%%</title>
No exemplo acima, note como a variável de exibição %%PAGETITLE%% está inserida normalmente em meio a tags HTML. No momento em que o Axe gera uma nova página ou reconstroi seus arquivos, ela será substituída pelo título de cada página, automaticamente.
As variáveis de exibição se dividem em 2 grupos: as referentes a um post, e as referentes ao blog como um todo – e ambos os grupos podem ser usados simultaneamente em qualquer arquivo de um tema.
Variáveis de exibição referentes a um post
As variáveis a seguir representam informações sobre o post ativo, ou seja, aquele que está sendo incluído neste momento em um índice, um feed, ou na sua própria página.
O tema default incluído no Axe serve como exemplo do uso da maioria delas.
Segue a lista:
- %%POSTANOMES%% – data de publicação do post, no formato AAAA/MM
- %%POSTAUTHOR%% – o autor do post corrente
- %%POSTAUTHORTWITTER%% – o twitter do autor do post corrente
- %%POSTAUTHORURL%% – a URL do autor do post corrente
- %%POSTBIO%% – a biografia resumida do autor do post corrente (se o arquivo correspondente constar no diretório axe/authors)
- %%POSTBODY%% – o corpo de texto completo do post corrente
- %%POSTDATE%% – data de publicação do post, no formato AAAA/MM/DD
- %%POSTICON%% – o ícone definido para o post, ou o ícone do blog, se não houver
- %%POSTMID%% – a chamada para o post corrente, criada a partir de suas frases iniciais
- %%POSTNAME%% – o caminho web do post, no formato AAAA/MM/titulo-do-post.html
- %%POSTNEWSBODY%% – o corpo de texto completo do post corrente, sem separação de parágrafos
- %%POSTOLDCOMMENTS%% – comentários antigos que tenham sido importados do WordPress, apenas para exibição.
- %%POSTSHARETHIS%% – URL completa para o leitor compartilhar o post no Facebook usando a API do serviço
- %%POSTTAGS%% – as tags (assuntos, temas) do post, já com links aplicados.
- %%POSTTIME%% – data e hora de publicação do post, no formato da RFC 2822. Exemplo: Thu, 21 Dec 2000 16:01:07 +0200
- %%POSTTITLE%% – o título do post
- %%POSTTWIT%% – uma frase curta descrevendo o post (ou o título do post, caso não esteja definida), seguida da URL completa do post.
- %%POSTTWITTHIS%% – URL completa para o leitor compartilhar o post no Twitter usando a API do serviço
- %%POSTURL%% – o mesmo que %%POSTNAME%%
Incluindo variáveis no arquivo-texto de entrada
O arquivo-texto de entrada, que você cria no seu editor de textos favorito para depois gravar no diretório axe/staging
e dar início ao processo de publicação, também pode (opcionalmente) definir explicitamente variáveis de exibição referentes ao post, uma por linha, após o final do texto do corpo do post.
Neste caso, ao invés de cercar o nome da variável com 2 pares de sinais de percentual, ele deve ser precedido de um par de arrobas, e seguido de um sinal de dois pontos, como no exemplo a seguir:
Este é o penúltimo parágrafo do texto.
Este é o último parágrafo do texto.
@@POSTAUTHOR:Miguel de Cervantes
@@POSTAUTHORTWITTER:@cervantes
Variáveis de exibição referentes ao blog como um todo
A configuração e estrutura do blog constam em uma série adicional de variáveis de exibição.
Várias delas vêm diretamente das definições do arquivo axe/axe_config.php
(e os detalhes sobre elas encontram-se explicados junto ao modelo deste que acompanha o Axe), enquanto outras são computadas a partir do ambiente do blog.
Segue a lista das variáveis gerais:
- %%AXEVERSION%% – a versão do Axe em execução
- %%BLOGICON%% – a URL do ícone geral do blog
- %%BLOGLOCALE%% – o idioma do blog. Default: pt_BR
- %%BLOGMOTTO%% – o lema ou subtítulo do blog
- %%BLOGOWNER%% – o nome do criador do blog
- %%BLOGOWNERTWITTER%% – o twitter do criador do blog
- %%BLOGOWNERURL%% – a url do criador do blog
- %%BLOGROOT%% – o diretório em que o blog foi instalado, no qual podem ser encontrados os subdiretórios
axe
eaxethemes
- %%BLOGTITLE%% – o nome do blog
- %%BLOGTWITTER%% – o twitter do blog
- %%FEEDURL%% – a URL pública do feed do blog (que sempre será gerado automaticamente em
%%POSTSDIR%%feed.xml
) - %%LASTBUILDDATE%% – a data em que a página corrente está sendo gerada
- %%NAVLINKS%% – os links para avançar e retroceder uma página, para uso em temas de índices
- %%NUMFEATSCOVER%% – o número de posts em destaque na capa
- %%NUMPOSTSCOVER%% – o número total de posts na capa
- %%NUMPOSTSFEED%% – o número total de posts no feed
- %%PAGEDESC%% – a descrição curta da página corrente
- %%PAGEICON%% – o ícone da página atual
- %%PAGEURL%% – a URL completa da página corrente
- %%YEAR%% – o ano corrente
Segue a lista das variáveis referentes a diretórios do servidor (não deixe de ler a documentação de Estrutura de diretórios e arquivos do Axe):
- %%DRAFTSDIR%% – o diretório de drafts, onde ficam os posts pré-publicados
- %%INPUTDIR%% – o diretório onde ficam os arquivos de dados referentes aos posts já publicados (descriptors, na configuração default)
- %%PLUGINSDIR%% – o diretório onde podem ser instalados plugins. A interface de plugins ainda não foi documentada.
- %%POSTSDIR%% – o diretório onde são gravados os índices, tags, feed, sitemap e os subdiretórios de posts publicados em HTML.
- %%PREVIEWDIR%% – o diretório onde são gravados os previews.
- %%STAGINGDIR%% – o diretório staging, onde são gravados os arquivos-texto para publicação
- %%THEMESDIR%% - o diretório em que estão os temas instalados
- %%THEME%% - o diretório do tema ativo, em relação ao %%THEMESDIR%%. Default:
panzer/
Segue a lista das variáveis referentes a URLs:
- %%BLOGURL%% – A URL da raiz do blog
- %%PAGEURL%% – A URL da página sendo gerada
- %%POSTSURLPREFIX%% – o prefixo da URL dos posts (normalmente em branco)
- %%PREVIEWSBASEURL%% – a URL completa do diretório de previews
- %%THEMESPATH%% – o caminho web do diretório
axethemes
Segue a lista das variáveis para inserção do conteúdo de arquivos opcionais inseridos no diretório do tema:
- %%BODYAD%% – bodyad.php
- %%MENU%% – menu.php
- %%MIDAD%% – midad.php
- %%RIGHTAD%% – rightad.php
- %%SEARCH%% – search.php
- %%SIDEBAR%% – sidebar.php
- %%TOPAD%% – topad.php
É possível combinar uma sequência de variáveis: por exemplo, para um link completo para um post ancorado no seu título, uma alternativa seria definir o seguinte trecho em um tema:
<a href="%%BLOGURL%%%%POSTSURLPREFIX%%%%POSTURL%%">%%POSTTITLE%%</a>