O arquivo de configuração do Axe

O arquivo axe/axe_config.txt não vem incluído na instalação do seu Axe, mas você pode (e deve) copiar o arquivo axe/axe_config_exemplo.txt para que ele se torne o axe/axe_config.txt que você irá editar para fazer o seu blog funcionar.

Se tudo correr bem, este é o único arquivo (além dos seus posts, claro) que você irá precisar editar para fazer o seu blog funcionar.

Trata-se de um arquivo em PHP, portanto cuidado para preservar a sua sintaxe.

Veremos a seguir cada uma das opções do arquivo, com comentários.

Título, descrição breve e a URL de uma imagem para servir de ícone do blog:

$blogparms["BLOGTITLE"] = 'Meu Blog';
$blogparms["BLOGMOTTO"] = "Testando o CMS AXE... e aprovando";
$blogparms["BLOGLOGO"] = "http://www.seu-site.com/img/bloglogo.png";

URL da raiz do blog, terminando com uma barra:
$blogparms["BLOGURL"] = 'http://seu-site.com/blog/';

Diretório em que está o executável axe.php:
$axedir='/users/fulano/www/blog/axe/';

Dentro do diretório acima precisam existir os diretórios a seguir:

  • staging - é onde você grava os arquivos-texto de entrada contendo os seus posts, em txt puro ou com HTML.
  • drafts - onde o Axe grava os posts pré-publicados, prontos para preview, postar ou atualizar.
  • descriptors - onde o Axe grava os arquivos de dados correspondentes aos posts já publicados.

Twitter do blog, sem @
$blogparms["BLOGTWITTER"] = 'blogtwitter';

URL para acesso externo ao feed
$blogparms["FEEDURL"] = 'http://seu-site.com/blog/feed.xml';

Dados de identificação do autor do blog: nome, URL, twitter (sem @)
$blogparms["BLOGOWNER"] = 'Fulano de Tal';
$blogparms["BLOGOWNERURL"] = 'http://url-do-dono.com/';
$blogparms["BLOGOWNERTWITTER"] = 'donotwitter';

Quantidade de posts no feed, e de posts e de destaques na capa
$blogparms["NUMPOSTSFEED"] = '10';
$blogparms["NUMPOSTSCOVER"] = '10';
$blogparms["NUMFEATSCOVER"] = '2'; // numero de destaques na capa

(observação: nem todo tema diferencia destaques e posts)

Diretório dos temas no servidor
$blogparms["THEMESDIR"] = '/users/fulano/www/blog/axethemes/';

Caminho web dos temas (em relação à raiz do blog). Começa sem e termina com /
$blogparms["THEMESPATH"] = 'axethemes/';

Pasta do tema do blog (dentro do THEMESDIR/THEMESPATH)
$blogparms["THEME"] = 'panzer/';

Diretório-base dos plugins
$blogparms["PLUGINSDIR"] = $axedir.'plugins/';

Diretório-raiz do blog, onde constam os posts publicados em HTML, os indices, tags e feed, bem como os subdiretórios axe e axethemes:
$blogparms["POSTSDIR"] = '/users/fulano/www/blog/';

Caminho web da raiz até o diretório de posts. Começa sem "/" e termina com "/"
O caso normal é esta variável ficar vazia. //TO-DO: documentar o uso.
$blogparms["POSTSURLPREFIX"] = '';

Diretório onde serão gravados os previews (em HTML) de posts, gerados pelo axe.php -v
$blogparms["PREVIEWDIR"] = '/users/fulano/www/blog/axepreview/';

# A URL completa do diretório de previews. Termina com "/"
$blogparms["PREVIEWSBASEURL"] = 'http://seu-site.com/blog/axepreview/';

Idioma, verbosidade e localização. Na dúvida, não altere.
$blogparms["BLOGLOCALE"] = 'pt_BR';
error_reporting(E_ALL ^ E_NOTICE ^ E_USER_NOTICE);
date_default_timezone_set('America/Sao_Paulo');

Após editar, grave-o com o nome de axe/axe_config.php e você já poderá experimentar os comandos básicos do Axe.

Os arquivos que definem o tema

Se você for editar ou alterar um tema, segue a lista dos arquivos que a versão atual do Axe suporta. Eles residem imediatamente abaixo da pasta do tema – na configuração default, eles estão em axethemes/panzer/.

Cabeçalho e rodapé HTML, aplicáveis à capa, índices e posts individuais:

  • header.php - se o seu tema tiver sidebar esquerda, insira-a aqui, juntamente com o cabeçalho.
  • footer.php - se o seu tema tiver sidebar direita, insira-a aqui, juntamente com o rodapé.

Posts da capa e índices, incluindo o de tags:

Arquivo individual do post:

  • single-body.php - o post em si
  • single-body-preview.php - uma visualização adicional incluída abaixo do rodapé no momento do preview (opcional)

Feed RSS: cabeçalho, item e rodapé

  • feed.header
  • feed.item
  • feed.footer