Membina Plugin Generator Generator Statik

Anda mungkin biasa dengan penjana tapak statik seperti Jekyll dan Wintersmith. Tutorial ini menunjukkan membina plugin grunt adat untuk menghasilkan tapak statik dari templat dan fail markdown, yang menawarkan kawalan dan integrasi yang lebih besar dengan aliran kerja anda yang sedia ada.

Kelebihan utama menggunakan Grunt:

Pendekatan ini memberikan beberapa faedah:

Penyesuaian dan Integrasi:
• Leverage Grunt's API dan Ecosystem Plugin untuk Penyesuaian yang luas dan Integrasi Lancar dengan Alat Lain. Fleksibiliti aliran kerja:
menyesuaikan proses penjanaan tapak statik anda dengan keperluan tepat anda, memilih preprocessors dan kaedah penyebaran CSS yang disukai.
• Reka bentuk modular: Mudah tambahkan ciri melalui plugin grunt tambahan (mis., Generasi sitemap).
• sistem templating agnostisisme: menyesuaikan plugin ke enjin templating yang berbeza seperti hendal atau jed.
• Persediaan:

Dengan mengandaikan anda mempunyai git, node.js, dan grunt-cli dipasang, ikuti langkah-langkah ini:

Pasang

:

1. Pasang templat plugin grunt: grunt-init npm install -g grunt-init
Buat direktori projek (mis.,
2. ). git clone git://github.com/gruntjs/grunt-init-gruntplugin.git ~/.grunt-init/gruntplugin
Inisialisasi plugin Grunt:
3. (jawab arahan; lalai boleh diterima). grunt-mini-static-blog
Pasang kebergantungan:
4. grunt-init gruntplugin
Pasang modul tambahan:
5. npm install
6. npm install handlebars highlight.js meta-marked moment rss lodash --save-dev Menjana catatan blog:

Fungsi teras melibatkan menjana catatan blog individu. Ubah suai untuk memasukkan konfigurasi berikut untuk :

3 Templat ini menggunakan hendal. Gruntfile.js mini_static_blog

kod plugin (mini_static_blog.js):

mini_static_blog: {
  default: {
    options: {
      data: {
        author: "Your Name",
        url: "http://yourwebsite.com",
        disqus: "", // Disqus username (optional)
        title: 'My Blog',
        description: 'My Blog Description'
      },
      template: {
        post: 'templates/post.hbs',
        page: 'templates/page.hbs',
        index: 'templates/index.hbs',
        header: 'templates/partials/header.hbs',
        footer: 'templates/partials/footer.hbs',
        notfound: 'templates/404.hbs'
      },
      src: {
        posts: 'content/posts/',
        pages: 'content/pages/'
      },
      www: {
        dest: 'build'
      }
    }
  }
}

templates/post.hbs Logik teras berada dalam templates/page.hbs. Kod ini mengendalikan parsing markdown, rendering templat, dan penulisan fail. Bahagian ini termasuk pemprosesan markdown dengan penonjolan sintaks, kompilasi templat, generasi pasca, generasi halaman, penciptaan suapan RSS, dan 404 penciptaan halaman. Kod ini juga menguruskan penomboran untuk halaman indeks. (Kod yang lengkap dan terperinci terlalu luas untuk dimasukkan ke sini, tetapi struktur dan elemen utama diterangkan di atas.) templates/index.hbs

Perkembangan selanjutnya:

Plugin ini membentuk asas untuk penjana tapak statik yang lebih komprehensif. Pertimbangkan penambahbaikan ini:

• Fungsi carian (lunr.js): Mengintegrasikan indeks carian untuk navigasi tapak yang lebih baik.
• Sokongan kategori: Tambah sokongan untuk mengkategorikan catatan blog.
• Templating Alternatif: Terokai enjin templat lain.
• mengulas lanjutan: mengintegrasikan lebih banyak sistem komen yang mantap.

Tutorial ini menyediakan titik permulaan yang kukuh untuk membuat penjana tapak statik yang disesuaikan menggunakan Grunt. Ingatlah untuk berunding dengan kod lengkap (tersedia di [pautan ke kod sumber - ganti dengan pautan sebenar jika tersedia]) untuk pelaksanaan terperinci.

Atas ialah kandungan terperinci Membina Plugin Generator Generator Statik. Untuk maklumat lanjut, sila ikut artikel berkaitan lain di laman web China PHP!