Download Blended - download do código-fonte Blended

Blended

Outras categorias

1.0.0

Baixar

Misturado

Blended é um gerador de sites estáticos escrito em Python e licenciado sob a licença de código aberto GPL 3.0. Ele suporta um sistema de templates baseado em HTML, conteúdo escrito em HTML, Markdown, Textile, reStructuredText, Jade, Docx e Plain Text. Ele também suporta a compilação de SASS, Less, Stylus e CoffeeScript. O Blended facilita a implantação de seus sites, incluindo um uploader de FTP integrado. Além disso, o Blended é altamente atualizável porque tem suporte para um sistema de plugins Python.

Instalando

Para instalar o Blended do PyPi (recomendado), execute:

pip install blended

Para compilar e instalar o Blended a partir do código-fonte, execute:

git clone https://github.com/johnroper100/Blended.git

cd Blended

pip install .

Correndo

Para usar o Blended depois de instalado, execute:

blended init

Isso o ajudará a iniciar um novo site. Se precisar de ajuda, execute:

blended --help

e você verá todos os comandos disponíveis.

Construindo Seu Site

Para construir o site que você criou com Blended run

blended build

ou

blended interactive (para criação de alterações no arquivo)

Para qualquer comando executado, você pode especificar uma alternativa --outdir para construir ou visualizar. Por exemplo, para construir na pasta source_output , execute blended build --outdir source_output .

Dentro do arquivo config.py , você pode definir minify_css e minify_js como true para otimizar seus arquivos CSS e JS após a construção.

Trabalhando com modelos

Você pode instalar modelos do GitHub usando blended install-template .

Cada site Blended usa quatro arquivos de modelo:

header.html (obrigatório)
rodapé.html (obrigatório)
home_page.html (não é obrigatório, mas o site parece melhor)
content_page.html (não é obrigatório, mas o site parece melhor)
nav(name).html (Você pode ter até 6 modelos de navegação diferentes. Por exemplo, navTest.html ou nav_test.html )
page_list_item.html (não obrigatório, se usado, substituirá o conteúdo de cada item da lista de páginas. Pode ter as variáveis {name} , {content} , {content_short} , {date} , {day} , {month} , {month_name} {year} , {path} )

Nestes arquivos você coloca a marcação de cada seção a ser gerada.

Ao trabalhar com páginas, você pode especificar opcionalmente qual modelo deseja (diferente de content_page.html ) adicionando o nome do arquivo de modelo sem a extensão na primeira linha da página e, em seguida, pelo menos cinco + s na segunda linha . Por exemplo, se eu quisesse usar um modelo chamado blog_page.html para uma determinada página, colocaria

 blog_page
+++++

no topo da página. Certifique-se de colocá-lo no topo ou então não funcionará!

Você tem algumas variáveis que pode usar em seus modelos para obter valores durante a construção:

{website_name}
{website_description}
{website_description_long} (use para descrições longas, como a biografia de um autor)
{author_name}
{author_bio}
{website_language}
{website_license}
{website_url}
{page_content} (só pode ser usado no arquivo de modelo content_page.html)
{page_date} (data/hora em que a página foi escrita/modificada)
{page_day} (dia em que a página foi escrita/modificada)
{page_month} (mês em que a página foi escrita/modificada)
{page_month_name} (Nome do mês em que a página foi escrita/modificada)
{page_year} (ano em que a página foi escrita/modificada)
{relative_root} (retorna um caminho relativo para o arquivo atual)
{random_number}
{build_date}
{build_time}
{build_datetime}
{ (page_filename) _active} (Ao construir, se a página ativa for igual ao nome do arquivo na tag, a tag será substituída por active ex. {getting-started.html_active} )
{nav (nome) } (Use para colocar barras de navegação. Para adicionar uma barra de navegação, escreva nav mais alguma outra coisa. Por exemplo, {nav2} ou {nav_test} )
{page_list} (lista todas as páginas no formato <ul><li><a href="page-name.html">page-name</a></li></ul> )
{page_file} (o nome completo do arquivo da página. ex. getting-started.html )
{page_filename} (o nome do arquivo da página sem a extensão .html. ex. getting-started )
{page_name} (fornece o nome da página atual. Torna o nome da página mais bonito. Por exemplo, getting-started.html é convertido em Getting Started )
{page_folder} (fornece o nome da pasta da página atual. Torna o nome da pasta mais bonito. Por exemplo, getting-started é convertido em Getting Started )
{page_folder_orig} (fornece o nome da pasta da página atual)
{blended_version} (fornece a versão atual do Blended)
{blended_version_message} (Fornece a versão atual do Blended com uma bela mensagem: Built with Blended v4.9 )

Onde quer que você coloque essas variáveis nos modelos, elas serão substituídas pelos valores no seu arquivo config.py. As variáveis devem permanecer entre colchetes. Você pode até colocar variáveis dentro do conteúdo de outras variáveis!

Trabalhando com plug-ins

Você pode instalar plug-ins do PyPi, por exemplo pip install blended_google_analytics . Você também pode instalar plug-ins do GitHub usando blended install-plugin .

Para usar plugins, inclua-os na lista plugins em config.py .

Se o plugin for chamado em seus modelos, ex. {html_comment_box} e insira-o na lista de plug-ins como plugins = ["html_comment_box"] .

Você pode usar vários plug-ins ao mesmo tempo, por exemplo. plugins = ["html_comment_box", "minify_images"]

Trabalhando com variáveis personalizadas

Dentro do seu config.py existe uma variável custom_variables = {} . Este é um dicionário de todas as variáveis personalizadas que você gostaria de usar. Para adicionar uma variável, adicione-a como um item de dicionário.

Aqui estão alguns exemplos:

custom_variables = {"software_name": "Blended"}

custom_variables = {"software_name": "Blended", "software_version": "5.0"}

Importando do WordPress

Você pode importar um site e postagens do WordPress. Para isso, exporte do WordPress através da opção Posts e baixe o arquivo para o diretório onde deseja gerar seu site.

Execute o comando blended import-wp e ele solicitará o nome/caminho do arquivo. Digite o nome do arquivo e o Blended criará um novo site com as informações.

Importando do Blogger

Você pode importar postagens do Blogger. Para isso, exporte do Blogger através da opção Backup Site e baixe o arquivo para o diretório onde deseja gerar seu site.

Execute o comando blended import-blogger e ele solicitará o nome/caminho do arquivo. Digite o nome do arquivo e o Blended criará um novo site com as informações.