Téléchargement Blended - Téléchargement du code source Blended

Blended

Autres catégories

1.0.0

Télécharger

Mélangé

Blended est un générateur de sites Web statiques écrit en Python et sous licence open source GPL 3.0. Il prend en charge un système de modèles basé sur HTML, du contenu écrit en HTML, Markdown, Textile, reStructuredText, Jade, Docx et Plain Text. Il prend également en charge la compilation de SASS, Less, Stylus et CoffeeScript. Blended facilite le déploiement de vos sites Web en incluant un téléchargeur FTP intégré. De plus, Blended est puissamment évolutif car il prend en charge un système de plugin Python.

Installation

Pour installer Blended à partir de PyPi (recommandé), exécutez :

pip install blended

Pour créer et installer Blended à partir des sources, exécutez :

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

cd Blended

pip install .

En cours d'exécution

Pour utiliser Blended après l'avoir installé, exécutez :

blended init

Cela vous aidera à démarrer un nouveau site Web. Si vous avez besoin d'aide, exécutez :

blended --help

et vous verrez toutes les commandes disponibles.

Construire votre site

Pour construire le site que vous avez créé avec Blended run

blended build

ou

blended interactive (pour la création de modifications sur fichier)

Pour toute commande que vous exécutez, vous pouvez spécifier un autre --outdir à partir duquel créer ou afficher. Par exemple, pour créer dans le dossier source_output , exécutez blended build --outdir source_output .

Dans le fichier config.py , vous pouvez définir minify_css et minify_js sur true pour optimiser vos fichiers CSS et JS après la construction.

Travailler avec des modèles

Vous pouvez installer des modèles depuis GitHub à l’aide de blended install-template .

Chaque site Web Blended utilise quatre fichiers modèles :

en-tête.html (obligatoire)
footer.html (obligatoire)
home_page.html (Pas obligatoire mais le site est plus beau)
content_page.html (Pas obligatoire mais le site est plus beau)
nav(name).html (Vous pouvez avoir jusqu'à 6 modèles de navigation différents. Par exemple, navTest.html ou nav_test.html )
page_list_item.html (Non obligatoire, s'il est utilisé, cela remplacera le contenu de chaque élément de liste de pages. Peut avoir les variables {name} , {content} , {content_short} , {date} , {day} , {month} , {month_name} {year} , {path} )

Dans ces fichiers vous placez le balisage pour chaque section à générer.

Lorsque vous travaillez avec des pages, vous pouvez éventuellement spécifier le modèle souhaité (autre que content_page.html ) en ajoutant le nom du fichier modèle sans l'extension à la première ligne de la page, puis au moins cinq + s à la deuxième ligne. . Par exemple, si je voulais utiliser un modèle appelé blog_page.html pour une certaine page, je mettrais

 blog_page
+++++

en haut de la page. Assurez-vous de le mettre en haut, sinon cela ne fonctionnera pas !

Vous disposez de certaines variables que vous pouvez utiliser dans vos modèles pour extraire des valeurs lors de la construction :

{website_name}
{website_description}
{website_description_long} (À utiliser pour les descriptions longues comme la biographie d'un auteur)
{author_name}
{author_bio}
{website_language}
{website_license}
{website_url}
{page_content} (Peut être utilisé uniquement dans le fichier modèle content_page.html)
{page_date} (Date/heure à laquelle la page a été écrite/modifiée)
{page_day} (jour où la page a été écrite/modifiée)
{page_month} (Mois pendant lequel la page a été écrite/modifiée)
{page_month_name} (Nom du mois où la page a été écrite/modifiée)
{page_year} (Année où la page a été écrite/modifiée)
{relative_root} (Renvoie un chemin relatif pour le fichier actuel)
{random_number}
{build_date}
{build_time}
{build_datetime}
{ (page_filename) _active} (Lors de la construction, si la page active est égale au nom de fichier dans la balise, la balise est remplacée par active ex. {getting-started.html_active} )
{nav (name) } (Utilisez pour placer des barres de navigation. Pour ajouter une barre de navigation, écrivez nav plus autre chose. Par exemple, {nav2} ou {nav_test} )
{page_list} (répertorie toutes les pages au format <ul><li><a href="page-name.html">page-name</a></li></ul> )
{page_file} (Le nom de fichier complet de la page. ex. getting-started.html )
{page_filename} (le nom de fichier de la page sans l'extension .html. ex. getting-started )
{page_name} (Donne le nom de la page actuelle. Rend le nom de la page plus joli. Par exemple, getting-started.html est converti en Getting Started )
{page_folder} (Donne le nom du dossier de la page actuelle. Rend le nom du dossier plus joli. Par exemple, getting-started est converti en Getting Started )
{page_folder_orig} (Donne le nom du dossier de la page actuelle)
{blended_version} (donne la version actuelle de Blended)
{blended_version_message} (Donne la version actuelle de Blended avec un joli message : Built with Blended v4.9 )

Partout où vous placez ces variables dans les modèles, elles seront remplacées par les valeurs de votre fichier config.py. Les variables doivent rester entre parenthèses. Vous pouvez même placer des variables dans le contenu d’autres variables !

Travailler avec des plugins

Vous pouvez installer des plugins depuis PyPi, par exemple pip install blended_google_analytics . Vous pouvez également installer des plugins depuis GitHub en utilisant blended install-plugin .

Pour utiliser des plugins, incluez-les dans la liste plugins dans config.py .

Si le plugin est destiné à être appelé dans vos modèles, ex. {html_comment_box} puis insérez-le dans la liste des plugins comme plugins = ["html_comment_box"] .

Vous pouvez utiliser plusieurs plugins à la fois, par exemple. plugins = ["html_comment_box", "minify_images"]

Travailler avec des variables personnalisées

À l'intérieur de votre config.py il y a une variable custom_variables = {} . Il s'agit d'un dictionnaire de toutes les variables personnalisées que vous souhaitez utiliser. Pour ajouter une variable, ajoutez-la en tant qu'élément de dictionnaire.

Voici quelques exemples :

custom_variables = {"software_name": "Blended"}

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

Importation depuis WordPress

Vous pouvez importer un site Web et des publications depuis WordPress. Pour ce faire, exportez depuis WordPress à l'aide de l'option Posts et téléchargez le fichier dans le répertoire où vous souhaitez générer votre site Web.

Exécutez la commande blended import-wp et elle vous demandera le nom/chemin du fichier. Tapez le nom du fichier et Blended créera un nouveau site Web avec les informations.

Importation depuis Blogger

Vous pouvez importer des articles depuis Blogger. Pour ce faire, exportez depuis Blogger à l'aide de l'option Backup Site et téléchargez le fichier dans le répertoire où vous souhaitez générer votre site Web.

Exécutez la commande blended import-blogger et elle vous demandera le nom/chemin du fichier. Tapez le nom du fichier et Blended créera un nouveau site Web avec les informations.