Repositori ini memberi Anda kode yang Anda perlukan untuk memulai situs web pribadi yang menampilkan pekerjaan Anda sebagai pengembang perangkat lunak. Dan ketika Anda mengelola kode dalam repositori GitHub, itu akan secara otomatis membuat halaman web dengan informasi profil pemilik, termasuk foto, bio, dan repositori.
Situs web pribadi Anda sedang menunggu untuk dipersonalisasi. Ini termasuk ruang untuk menyoroti bidang spesifik Anda yang menarik dalam pengembangan perangkat lunak, seperti bahasa atau industri. Dan itu berdiri untuk mempublikasikan posting blog hebat Anda berikutnya.
Semuanya mungkin menggunakan kombinasi Jekyll (untuk membangun situs web Anda), halaman GitHub (untuk hosting situs web Anda), dan API GitHub (untuk secara otomatis mengisi situs web Anda dengan konten).
github/personal-website
Repo Anda akan membuat salinan repositori "Starter Situs Web Pribadi" sendiri sehingga Anda memiliki proyek sendiri untuk disesuaikan. "Garpu" adalah salinan repositori. Jadi pilih "Fork" di atas repositori github/personal-website
.
Setelah Anda menemukan rumah untuk repositori bercabang Anda, itu milik Anda. Anda adalah pemiliknya, jadi Anda siap untuk diterbitkan, jika diinginkan.
Jika Anda ingin mengelola situs web Anda di lingkungan pengembangan web lokal, Anda akan menggunakan Ruby.
Setelah Anda menemukan rumah untuk repositori bercabang Anda, klon .
Jekyll adalah permata ruby yang dapat dipasang di sebagian besar sistem.
gem install jekyll bundler
cd personal-website
bundle install
bundle exec jekyll serve
Saat Anda meng -host kode situs web pribadi Anda di GitHub, Anda mendapatkan dukungan dari hosting gratis melalui halaman GitHub.
Pendekatan tercepat adalah mengganti nama username.github.io
Anda, di mana username
adalah nama pengguna GitHub Anda (atau nama organisasi). Kemudian, lain kali Anda mendorong perubahan apa pun ke cabang master
repositori Anda, mereka akan dapat diakses di web di nama username.github.io
Anda.
Jika Anda ingin menggunakan domain khusus , Anda ingin menambahkannya ke pengaturan "domain khusus" repositori Anda di github.com. Dan kemudian mendaftar dan/atau mengkonfigurasi domain Anda dengan penyedia DNS.
Ini situs web Anda, dan Anda mengontrol kode sumbernya. Jadi Anda dapat menyesuaikan semuanya, jika Anda suka. Tetapi kami telah memberikan beberapa kustomisasi cepat untuk Anda pertimbangkan saat Anda menyelesaikan situs web Anda.
Sebagian besar kustomisasi dapat dilakukan dalam hitungan detik, dengan merevisi file _config.yml
repositori Anda. Ingatlah untuk restart server lokal Anda setiap kali Anda menyimpan perubahan baru sehingga situs web bertenaga jekyll Anda membangun kembali dengan benar:
jekyll serve
Secara default, situs web Anda akan ditampilkan dalam tata letak dua kolom pada perangkat layar yang lebih besar, dengan foto, nama, dan informasi dasar Anda yang ditampilkan di "bilah sisi" yang selaras kiri. Tetapi Anda dapat dengan cepat beralih ke tata letak kolom tunggal "ditumpuk" dengan mengubah garis di file _config.yml
Anda yang membaca layout: sidebar
ke layout: stacked
.
Secara default, situs web Anda muncul dengan latar belakang putih dan abu -abu "terang", dengan teks gelap. Tetapi Anda dapat dengan cepat beralih ke latar belakang "gelap" dengan teks putih dengan mengubah garis dalam file _config.yml
Anda yang membaca style: light
ke style: dark
.
Situs web Anda dikonfigurasi dengan tiga topik (misalnya "Desain Web" dan "Sass") yang muncul di bagian berjudul "Minat My." Ini juga disimpan dalam file _config.yml
repositori Anda, di mana Anda dapat menentukan nama masing -masing topik dan dua detail opsional lainnya:
web_url
: Alamat web yang ingin Anda tautkan ke (misalnya https://github.com/topics/sass
).image_url
: Alamat web gambar (idealnya persegi) yang ingin Anda tampilkan dengan topik Anda. Untuk menambahkan halaman ke situs web Anda (misalnya resume terperinci):
.html
atau .md
baru di root repositori Anda.http://yoursite.dev/filename
). ---
layout: default
---
Untuk menambahkan posting blog ke situs web Anda:
.md
baru di repositori /_posts/
direktori Anda. YEAR-MONTH-DAY-title.MARKUP
---
title: "The title of my blog post"
---
Situs web Anda dilengkapi dengan posting blog placeholder yang dapat Anda referensi. Khususnya, materi depannya menyatakan published
sebagai false
, sehingga tidak akan muncul di situs web Anda.
Meskipun Anda juga dapat menentukan layout
di bagian depan, situs web Anda telah dikonfigurasi sebelumnya untuk menetapkan tata letak post
ke semua posting di /_posts/
direktori Anda. Jadi Anda tidak harus menyatakan itu di posting Anda, jika Anda tidak mau.
Konvensi Jekyll untuk menulis dan mengelola posting blog sangat fleksibel. Anda dapat mempelajari lebih lanjut dalam dokumentasi Jekyll untuk "posting."
Untuk memberi Anda dasar suara untuk memulai situs web pribadi Anda, repositori Anda mencakup beberapa "termasuk"-file .html
yang dinamis yang digunakan kembali di seluruh situs web Anda. Mereka semua disimpan di /_includes/
direktori.
Ada tersangka biasa, seperti header.html
dan footer.html
. Tetapi ada beberapa yang lebih layak ditunjukkan:
interests.html
: Daftar judul dan dinamis dari "My Interests," yang dihuni dengan topik yang Anda daftarkan di _config.yml
Anda.masthead.html
: Kumpulan avatar, nama, bio, dan metadata Anda yang ditampilkan secara mencolok di semua halaman web Anda untuk membantu mengidentifikasi apa situs web tersebut.post-card.html
: Presentasi yang ringkas dan diringkas dari posting blog, digunakan kembali untuk menampilkan daftar posting blog terbaru Anda.projects.html
: Daftar judul dan dinamis "Proyek Saya," yang dihuni dengan daftar repositori gitub terbaru Anda.repo-card.html
: Presentasi repositori yang ringkas dan diringkas, digunakan kembali untuk menampilkan daftar repositori gitub Anda.thoughts.html
: Daftar judul dan dinamis "My Thoughts," yang dihuni dengan daftar posting blog terbaru Anda.topic-card.html
: Presentasi topik yang ringkas dan diringkas (didefinisikan dalam _config.yml
Anda), digunakan kembali untuk menampilkan daftar minat Anda.Repositori Anda dilengkapi dengan tiga tata letak:
index.html
Anda beranda untuk menampilkan daftar proyek, minat, dan (opsional) posting blog Anda./_posts/
direktori.Konvensi Jekyll untuk mendefinisikan tata letak sangat fleksibel. Anda dapat mempelajari lebih lanjut tentang menyesuaikan tata letak Anda di jekyll "tata letak" dokumen.
Situs web Anda telah dikonfigurasikan sebelumnya untuk menggunakan kerangka kerja CSS yang sangat fleksibel yang disebut "Primer," bersama dengan gaya khusus yang Anda tulis di /assets/styles.scss
sass. Saat ini direferensikan dalam file styles.scss
Anda, menggunakan CSS Impor At-aturan:
@import url('https://unpkg.com/primer/build/build.css');
Anda, tentu saja, dipersilakan untuk menghapusnya atau menggantinya dengan kerangka kerja lain. Ingatlah bahwa HTML bahwa situs web Anda dikemas sebelumnya dengan referensi beberapa "kelas utilitas" primer untuk mendefinisikan hal-hal seperti lebar kolom, margin, dan warna latar belakang.
Tema ini tersedia sebagai open source di bawah ketentuan lisensi MIT.