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 e axethemes
  • %%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>