crônica - Online na nuvem

PROGRAMA:

NOME

crônica - Um compilador de blog simples.

SINOPSE

crônica [opções]

Opções de caminho:

--comments Especifique o caminho para o diretório de comentários opcionais.
--config Especifique um arquivo de configuração para ler.
--input Especifique o diretório de entrada a ser usado.
--output Especifique o diretório para gravar a saída.
--theme-dir Especifique o caminho para os modelos de tema.
--theme Especifique o tema a ser usado.
--pattern Especifique o padrão de arquivos com os quais trabalhar.
--url-prefix Especifique o prefixo para o blog ao vivo.
--sitemap-prefix Especifique o prefixo para o mapa do site.

Opções de entrada de blog:

--format Especifique o formato de suas entradas, HTML / têxtil / marcação.

Comandos de pré e pós-construção:

--pre-build Especifique um comando a ser executado antes de construir o blog.
--post-build Especifique um comando a ser executado assim que o blog for construído.
--pre-filter Um comando para filtrar cada entrada de blog antes da conversão de HTML.
--post-filter Um comando para filtrar cada entrada de blog após a conversão de HTML.

Opções de classificação:

--recent-date-first Mostra as entradas recentes primeiro na visualização do arquivo.
--recent-tags-first Mostra as entradas recentes primeiro na visualização da tag.

Opções de contagem:

--entry-count = N Número de postagens a serem mostradas no índice.
--rss-count = N Número de postagens a serem incluídas no feed de índice RSS.

Características opcionais:

--author Especifique o endereço de e-mail do autor
--comment-days Especifica o número máximo de posts para aceitar comentários.
--date-archive-path Inclui a data no arquivo.
--force Força a cópia de arquivos estáticos do tema do blog.
--lang Especifique o idioma a ser usado para formatar datas.
--lower-case Minúsculas todos os nomes de arquivos que são produzidos.
--no-archive Não cria uma página de arquivo.
--no-cache Não usa os recursos opcionais do memcached, mesmo se disponíveis.
--no-calendar Não usa o calendário opcional no índice.
--no-comments Não permite que comentários sejam postados.
--no-sitemap Não gera um mapa do site.
--no-tags Não produz nenhuma página de tag.
--no-xrefs Não produz nenhuma referência cruzada.

Opções de ajuda:

--help Mostra as informações de ajuda para este script.
--manual Leia o manual para este script.
--verbose Mostra informações úteis de depuração.
--version Mostra o número da versão e sai.

SOBRE NÓS

Chronicle é uma ferramenta simples para converter uma coleção de arquivos de texto,
localizado em um único diretório, em um blog que consiste em
Arquivos HTML.

Ele suporta apenas o mínimo de recursos que são necessários
Ser útil:

* Suporte de marcação.

* Suporte RSS.

* Suporte de arquivo.

As deficiências óbvias são:

* Falta de suporte para comentários instantâneos.

* Falta de suporte para pingback / trackback.

Dito isto, é um sistema robusto, estável e útil.

BLOG FORMATO

O formato dos arquivos de texto que processamos é fundamental para a saída
Páginas. Cada entrada deve ser parecida com isto:

Título: este é o título da postagem do blog
Data: 2 de março de 2007
Tags: um, dois, três, tag longa

O texto da sua entrada vai aqui.

NOTA: O cabeçalho DEVE ser separado do corpo da entrada por pelo menos um
única linha vazia.

Neste exemplo, podemos ver que a própria entrada foi precedida
com um pequeno cabeçalho. Um cabeçalho de entrada contém três linhas opcionais,
se estes não estiverem presentes, então existem padrões razoáveis, conforme descrito
abaixo.

A formatação das datas de saída pode ser alterada por meio do uso do
Opção de linha de comando B <--lang> (ou a opção "lang = francês" correspondente no
arquivo de configuração), mas a data da própria entrada deve ser especificada em
Inglês.

Título: descreve o título da postagem. Se não estiver presente, o nome do arquivo da entrada é usado
em vez de. "Assunto:" também pode ser usado.
Assunto: Este é um sinônimo para 'Título:'.
Data: a data em que a postagem foi escrita. Se não estiver presente, a hora de criação do arquivo é usada
ao invés.
Publicar: este cabeçalho é removido de todas as entradas e é usado pelo spooler de crônica
script.
Tags: todas as tags que devem ser associadas à entrada, separadas por vírgulas.

Presume-se que o formato da entrada seja HTML, no entanto, há suporte
para escrever suas entradas em formatos têxteis e de redução de custos.

O formato das entradas é especificado por meio do argumento B <--format>, ou
por meio de uma configuração "format: foo" em seu arquivo croniclerc.

O formato das entradas é considerado global; são todas as suas entradas
será considerado no mesmo formato. No entanto, você pode adicionar um
"format: foo" pseudo cabeçalho para entradas específicas se você deseja escrever
entradas específicas em um formato diferente.

Para permitir flexibilidade no tratamento das entradas, cada entrada do blog irá
ser passado pelo script de filtro B
o que permite que você modifique este tratamento em um único local. Esse
o script permite que as entradas sejam atualizadas por meio de filtros antes e depois
a conversão para HTML. Para mais detalhes, consulte a página de manual do
esse script.

CONFIGURAÇÃO

A configuração do software é mínima e geralmente executada
por meio dos argumentos da linha de comando. No entanto, é possível salvar as configurações
tanto no arquivo global / etc / chroniclerc ou por usuário ~ / .chroniclerc
arquivo.

Se desejar, pode passar o nome de outro arquivo de configuração para
o script com o sinalizador B <--config>. Isso será lido após o
dois arquivos anteriores, e pode substituir quaisquer configurações que estão presentes.

O arquivo de configuração contém linhas como estas:

input = / home / me / blog

output = / var / www / blog

formato = remarcação

Chaves desconhecidas são ignoradas.

OPCIONAL Cache

Para acelerar a reconstrução de um grande blog, o compilador pode usar um local
Daemon Memcached, se instalado e disponível.

Para instalar isso, em um sistema Debian GNU / Linux, execute:

apt-get update
apt-get instalar memcached libcache-memcached-perl

Você pode desabilitar este comportamento de cache com --no-cache, e ver o
efeito com --verbose.

OPCIONAL CALENDÁRIO

Se o módulo 'HTML :: CalendarMonthSimple' estiver disponível, cada blog irá
contêm uma visão simples do mês do mês atual no índice.

Para desativar isso, execute o programa com '--no-calendar'.

OPCIONAL COMENTÁRIOS

Incluído com o código da crônica, você deve encontrar o arquivo
cgi-bin / comments.cgi.

Este arquivo é projetado para escrever comentários enviados para o local
sistema de arquivos do seu servidor web. Se você instalar isso e editar o
caminho no início do script, você deve ser capaz de incluir
comentários em seu blog.

Resumindo, há três coisas que você precisa fazer:

Instale o script CGI e edite o caminho no início.
Copie os comentários de saída para a fonte do seu blog local.
Execute este script novamente com --comments =. / Path / to / comments

Isso deve incluir os comentários na saída estática. Mais
instruções explícitas são fornecidas dentro do arquivo 'COMENTÁRIOS'
incluídos na distribuição.

Use a crônica online usando os serviços onworks.net