Unduhan Blended - Unduhan kode Sumber Blended

Blended

Kategori lainnya

1.0.0

Unduh

Campuran

Blended adalah generator situs web statis yang ditulis dengan Python dan dilisensikan di bawah lisensi sumber terbuka GPL 3.0. Ini mendukung sistem templating berbasis HTML, konten yang ditulis dalam HTML, Markdown, Textile, reStructuredText, Jade, Docx, dan Plain Text. Ini juga mendukung kompilasi SASS, Less, Stylus, dan CoffeeScript. Blended memudahkan penerapan situs web Anda dengan menyertakan pengunggah FTP bawaan. Selain itu, Blended sangat dapat diupgrade karena memiliki dukungan untuk sistem plugin Python.

Menginstal

Untuk menginstal Blended dari PyPi (disarankan) jalankan:

pip install blended

Untuk membangun dan menginstal Blended dari sumber yang dijalankan:

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

cd Blended

pip install .

Berlari

Untuk menggunakan Blended setelah Anda menginstalnya, jalankan:

blended init

Ini akan membantu Anda memulai situs web baru. Jika Anda memerlukan bantuan, jalankan:

blended --help

dan Anda akan melihat semua perintah yang tersedia.

Membangun Situs Anda

Untuk membangun situs yang Anda buat dengan Blended run

blended build

atau

blended interactive (untuk pembuatan perubahan file)

Untuk perintah apa pun yang Anda jalankan, Anda dapat menentukan alternatif --outdir untuk dibuat atau dilihat. Misalnya, untuk membangun ke folder source_output , jalankan blended build --outdir source_output .

Di dalam file config.py , Anda dapat mengatur minify_css dan minify_js ke true untuk mengoptimalkan file CSS dan JS Anda setelah dibuat.

Bekerja Dengan templat

Anda dapat menginstal templat dari GitHub menggunakan blended install-template .

Setiap situs web Campuran menggunakan empat file templat:

header.html (Wajib)
footer.html (Wajib)
home_page.html (Tidak wajib tetapi situs terlihat lebih baik)
content_page.html (Tidak wajib tetapi situs terlihat lebih baik)
nav(name).html (Anda dapat memiliki hingga 6 templat nav yang berbeda. Misalnya, navTest.html atau nav_test.html )
page_list_item.html (Tidak wajib, jika digunakan, ini akan menggantikan setiap konten item daftar halaman. Dapat memiliki variabel {name} , {content} , {content_short} , {date} , {day} , {month} , {month_name} {year} , {path} )

Dalam file ini Anda menempatkan markup untuk setiap bagian yang akan dibuat.

Saat bekerja dengan halaman, secara opsional Anda dapat menentukan templat mana yang Anda inginkan (selain content_page.html ) dengan menambahkan nama file templat tanpa ekstensi ke baris pertama halaman, dan setidaknya lima + s ke baris kedua . Misalnya, jika saya ingin menggunakan template bernama blog_page.html untuk halaman tertentu, saya akan memasangnya

 blog_page
+++++

di bagian atas halaman. Pastikan Anda meletakkannya di atas atau itu tidak akan berhasil!

Anda memiliki beberapa variabel yang dapat Anda gunakan di templat Anda untuk menarik nilai saat membangun:

{website_name}
{website_description}
{website_description_long} (Gunakan untuk deskripsi panjang seperti biodata penulis)
{author_name}
{author_bio}
{website_language}
{website_license}
{website_url}
{page_content} (Hanya dapat digunakan di file template content_page.html)
{page_date} (Tanggal/Jam halaman ditulis/dimodifikasi)
{page_day} (Hari halaman ditulis/dimodifikasi)
{page_month} (Bulan halaman ditulis/dimodifikasi)
{page_month_name} (Nama bulan halaman tersebut ditulis/dimodifikasi)
{page_year} (Tahun halaman ditulis/dimodifikasi)
{relative_root} (Mengembalikan jalur relatif untuk file saat ini)
{random_number}
{build_date}
{build_time}
{build_datetime}
{ (page_filename) _active} (Saat membuat, jika halaman aktif sama dengan nama file di tag, tag diganti dengan active ex. {getting-started.html_active} )
{nav (name) } (Gunakan untuk menempatkan navbar. Untuk menambahkan navbar, tulis nav plus yang lain. Misalnya, {nav2} atau {nav_test} )
{page_list} (Daftar semua halaman dalam format <ul><li><a href="page-name.html">page-name</a></li></ul> )
{page_file} (Nama file lengkap halaman. mis. getting-started.html )
{page_filename} (nama file halaman tanpa ekstensi .html. mis. getting-started )
{page_name} (Memberikan nama halaman saat ini. Membuat nama halaman terlihat lebih cantik. Misalnya, getting-started.html diubah menjadi Getting Started )
{page_folder} (Memberikan nama folder pada halaman saat ini. Membuat nama folder terlihat lebih cantik. Misalnya, getting-started diubah menjadi Getting Started )
{page_folder_orig} (Memberikan nama folder halaman saat ini)
{blended_version} (Memberikan versi Blended saat ini)
{blended_version_message} (Memberikan versi Blended saat ini dengan pesan yang bagus: Built with Blended v4.9 )

Di mana pun Anda meletakkan variabel-variabel ini di templat, variabel tersebut akan digantikan dengan nilai di file config.py Anda. Variabel harus tetap berada dalam tanda kurung kurawal. Anda bahkan dapat memasukkan variabel ke dalam konten variabel lain!

Bekerja Dengan Plugin

Anda dapat menginstal plugin dari PyPi, misalnya pip install blended_google_analytics . Anda juga dapat menginstal plugin dari GitHub menggunakan blended install-plugin .

Untuk menggunakan plugin, sertakan plugin tersebut dalam daftar plugins di config.py .

Jika plugin dimaksudkan untuk dipanggil di template Anda, mis. {html_comment_box} lalu masukkan ke dalam daftar plugin seperti plugins = ["html_comment_box"] .

Anda dapat menggunakan beberapa plugin sekaligus, mis. plugins = ["html_comment_box", "minify_images"]

Bekerja Dengan Variabel Khusus

Di dalam config.py Anda ada variabel custom_variables = {} . Ini adalah kamus semua variabel khusus yang ingin Anda gunakan. Untuk menambahkan variabel, tambahkan variabel tersebut sebagai item kamus.

Berikut beberapa contohnya:

custom_variables = {"software_name": "Blended"}

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

Mengimpor dari WordPress

Anda dapat mengimpor situs web dan postingan dari WordPress. Untuk melakukannya, ekspor dari WordPress menggunakan opsi Posts dan unduh file ke direktori tempat Anda ingin membuat situs web.

Jalankan perintah blended import-wp dan itu akan menanyakan nama/jalur file dari file tersebut. Ketik nama file dan Blended akan membuat situs web baru dengan informasi tersebut.

Mengimpor dari Blogger

Anda dapat mengimpor postingan dari Blogger. Untuk melakukannya, ekspor dari Blogger menggunakan opsi Backup Site dan unduh file ke direktori tempat Anda ingin membuat situs web.

Jalankan perintah blended import-blogger dan itu akan meminta Anda untuk memasukkan nama/jalur file dari file tersebut. Ketik nama file dan Blended akan membuat situs web baru dengan informasi tersebut.