docslikecode

Dokumen menyukai kode

Situs web

Situs web ini dimaksudkan untuk menawarkan cerita dan artikel tentang cara memperlakukan dokumen seperti kode, dan pelajaran yang dipelajari di sepanjang jalan. Anda dipersilakan untuk menceritakan kisah Anda di sini juga.

Untuk berkontribusi

Anda dapat secara langsung mengirimkan permintaan tarik menggunakan alur kerja fork-and-pull untuk menambahkan artikel, atau mengirimkan ke repo JustWriteClick/Docs-like-code-stories jika Anda ingin mengikuti templat tanya jawab.

Mendorong ke cabang build memungkinkan Anda mempratinjau output build menggunakan netlify. Anda harus masuk ke Netlify untuk melihat penyebaran pratinjau.

Mendorong ke cabang main membangun output ke https://www.docslikecode.com menggunakan netlify. Penerbitan otomatis aktif sebagai pengaturan di Netlify, sehingga penyebaran dari main diterbitkan secara otomatis.

Tema Colophon

Tema milik https://mmistakes.github.io/so-simple-theme/

Untuk membangun secara lokal (macOS)

Uji penambahan Anda dan perubahan konten dengan menjalankan build lokal.

Pada macOS Anda perlu menginstal Brew, Bundler.io, dan Ruby Version Manager sehingga Anda dapat menggunakan versi Ruby tertentu:

1. Gunakan minuman untuk menginstal manajer versi ruby.

    $ brew install rbenv ruby-build
   

2. Tambahkan RBENV ke Bash sehingga memuat setiap kali Anda membuka terminal. Jika Anda menggunakan MacOS Catalina, file profil Anda mungkin .zshrc .

    $ echo 'if which rbenv > /dev/null; then eval "$(rbenv init -)"; fi' >> ~/.bash_profile
   

   atau

    $ echo 'if which rbenv > /dev/null; then eval "$(rbenv init -)"; fi' >> ~/.zshrc
   

3. Sumber file .bash_profile Anda. Jika Anda menggunakan MacOS Catalina, file profil Anda mungkin .zshrc .

    $ source ~/.bash_profile
   

   atau

    $ source ~/.zshrc
   

4. Instal versi Ruby yang diperlukan:

    $ rbenv install 2.7.1
   $ rbenv global 2.7.1
   $ rbenv version
   

   Sebagai imbalannya, Anda akan melihat ruby 2.7.1 2.7.1 (set by /Users/username/docslikecode/.ruby-version .

5. Jalankan gem install bundle untuk menginstal Bundler Gem, yang membantu dengan dependensi Ruby.

6. Jalankan bundle install pertama kali Anda berada di direktori docslikecode .

Untuk membangun secara lokal: Setelah Anda selesai mempersiapkan lingkungan Anda, maka Anda dapat membangun secara lokal dan meninjau situs di browser Anda.

1. Jalankan perintah serve.

    $ bundle exec jekyll serve
   

2. Gunakan URL Alamat Server http://127.0.0.1:4000/ di browser untuk melihat pratinjau konten.

3. Tekan Ctrl+C di terminal serve untuk menghentikan server.

Tip
Biarkan Terminal Sajian Terbuka dan Berjalan. Setiap kali Anda menyimpan perubahan pada file, secara otomatis meregenerasi situs sehingga Anda dapat segera menguji output. Satu -satunya file di mana perubahan memerlukan restart adalah file _config.yml .