minimal

Tema Minimal

Minimal adalah tema Jekyll untuk Halaman GitHub. Anda dapat melihat pratinjau tema untuk melihat tampilannya, atau bahkan menggunakannya saat ini.

Penggunaan

Untuk menggunakan tema Minimal:

1. Tambahkan yang berikut ke _config.yml situs Anda :

    remote_theme : pages-themes/[email protected]
   plugins :
   - jekyll-remote-theme # add this line to the plugins list if you already have one

2. Secara opsional, jika Anda ingin melihat pratinjau situs Anda di komputer, tambahkan yang berikut ini ke Gemfile situs Anda :

    gem "github-pages" , group : :jekyll_plugins 

Menyesuaikan

Variabel konfigurasi

Minimal akan mengikuti variabel berikut, jika disetel di _config.yml situs Anda:

 title : [The title of your site]
description : [A short description of your site's purpose]

Selain itu, Anda dapat memilih untuk menyetel variabel opsional berikut:

 show_downloads : ["true" or "false" (unquoted) to indicate whether to provide a download URL]
google_analytics : [Your Google Analytics tracking ID]

lembar gaya

Jika Anda ingin menambahkan gaya khusus Anda sendiri:

1. Buat file bernama /assets/css/style.scss di situs Anda
2. Tambahkan konten berikut ke bagian atas file, persis seperti yang ditunjukkan:

   ---
   ---
   
   @import " {{ site.theme }} " ;

3. Tambahkan CSS khusus (atau Sass, termasuk impor) yang Anda inginkan segera setelah baris @import

Catatan: Jika Anda ingin mengubah variabel Sass tema, Anda harus menetapkan nilai baru sebelum baris @import di stylesheet Anda.

Tata Letak

Jika Anda ingin mengubah tata letak HTML tema:

1. Untuk beberapa perubahan seperti favicon khusus, Anda dapat menambahkan file khusus di folder _includes lokal Anda. File yang disediakan bersama tema memberikan titik awal dan disertakan oleh templat tata letak asli.
2. Untuk perubahan yang lebih luas, salin templat asli dari repositori tema
   ( Kiat profesional: klik "mentah" untuk mempermudah penyalinan )
3. Buat file bernama /_layouts/default.html di situs Anda
4. Tempel konten tata letak default yang disalin pada langkah pertama
5. Sesuaikan tata letak sesuai keinginan Anda

Menyesuaikan kode Google Analytics

Google telah merilis beberapa iterasi pada kode Google Analytics mereka selama bertahun-tahun sejak tema ini pertama kali dibuat. Jika Anda ingin memanfaatkan kode terbaru, tempelkan ke _includes/head-custom-google-analytics.html di situs Jekyll Anda.

Mengganti URL yang dihasilkan GitHub

Templat sering kali mengandalkan URL yang disediakan oleh GitHub seperti tautan ke repositori Anda atau tautan untuk mengunduh proyek Anda. Jika Anda ingin mengganti satu atau beberapa URL default:

1. Lihat sumber template untuk menentukan nama variabel. Ini akan berbentuk {{ site.github.zip_url }} .
2. Tentukan URL yang Anda inginkan untuk digunakan templat di _config.yml situs Anda. Misalnya, jika variabelnya adalah site.github.url , Anda akan menambahkan yang berikut:

    github :
     zip_url : http://example.com/download.zip
     another_url : another value

3. Saat situs Anda dibuat, Jekyll akan menggunakan URL yang Anda tentukan, bukan URL default yang disediakan oleh GitHub.

Catatan: Anda harus menghapus site. awalan, dan setiap nama variabel (setelah github. ) harus diberi indentasi dengan dua spasi di bawah github: .

Untuk informasi selengkapnya, lihat dokumentasi variabel Jekyll.

Peta jalan

Lihat masalah yang masih terbuka untuk mengetahui daftar fitur yang diusulkan (dan masalah umum).

Filosofi proyek

Tema Minimal dimaksudkan untuk mempercepat dan memudahkan pengguna Halaman GitHub membuat situs web pertama (atau ke-100). Tema harus memenuhi sebagian besar kebutuhan pengguna, lebih mengutamakan kesederhanaan dibandingkan fleksibilitas, dan memberikan pengguna kesempatan untuk ikut serta dalam kompleksitas tambahan jika mereka memiliki kebutuhan khusus atau ingin menyesuaikan pengalaman mereka lebih lanjut. (seperti menambahkan CSS khusus atau mengubah tata letak default). Seharusnya juga terlihat bagus, tapi tidak perlu dikatakan lagi.

Berkontribusi

Tertarik untuk berkontribusi pada Minimal? Kami akan senang dengan bantuan Anda. Minimal adalah proyek sumber terbuka, yang dibangun dengan kontribusi satu per satu oleh pengguna seperti Anda. Lihat file KONTRIBUSI untuk instruksi bagaimana berkontribusi.

Pratinjau tema secara lokal

Jika Anda ingin melihat pratinjau tema secara lokal (misalnya, dalam proses mengusulkan perubahan):

1. Kloning repositori tema ( git clone https://github.com/pages-themes/minimal )
2. cd ke dalam direktori tema
3. Jalankan script/bootstrap untuk menginstal dependensi yang diperlukan
4. Jalankan bundle exec jekyll serve untuk memulai server pratinjau
5. Kunjungi localhost:4000 di browser Anda untuk melihat pratinjau tema

Menjalankan tes

Tema berisi rangkaian pengujian minimal, untuk memastikan situs dengan tema tersebut akan berhasil dibangun. Untuk menjalankan tes, cukup jalankan script/cibuild . Anda harus menjalankan script/bootstrap satu kali sebelum skrip pengujian dapat berfungsi.