Anda dapat menulis tutorial di Cloud Shell dan mempublikasikannya ke repositori Git jarak jauh. Pengguna dapat membaca tutorial tersebut untuk mulai menggunakan proyek Anda.
Dalam mode tutorial Cloud Shell, pengguna dapat mengklik baris perintah dalam dokumentasi untuk menjalankannya langsung di Cloud Shell.
Langkah 1: Buat file tutorial
Untuk membuat file tutorial, ikuti langkah-langkah berikut:
Buat folder di Cloud Shell untuk menyimpan file tutorial.
Contoh
mkdir tutorialsBuat file Markdown di direktori root folder. Sebagai contoh, jalankan perintah berikut untuk membuat file
tutorial.md:touch tutorial.md
Langkah 2: Tulis sebuah tutorial
Anda dapat menulis tutorial menggunakan sintaks Markdown. Saat menulis tutorial, perhatikan aturan berikut:
Gunakan tanda pagar (#) untuk membuat judul tingkat 1. Judul tingkat 1 adalah judul dari tutorial. Anda hanya dapat membuat satu judul tingkat 1 dalam sebuah tutorial.
Gunakan dua tanda pagar (##) untuk membuat judul tingkat 2. Judul tingkat 2 adalah judul dari sebuah langkah.
Tulis kode menggunakan sintaks Markdown. Cloud Shell akan merender kode Anda menjadi blok kode yang memiliki ikon Eksekusi di tutorial. Pengguna dapat mengklik ikon Eksekusi pada blok kode untuk menyalinnya ke editor Cloud Shell.
```bash aliyun help ```Gunakan instruksi direktori berikut dari Cloud Shell untuk menghasilkan struktur direktori untuk tutorial Anda:
<tutorial-nav></tutorial-nav>Gunakan instruksi buka file berikut dari Cloud Shell untuk menambahkan tautan file ke tutorial Anda. Pengguna dapat mengklik tautan dalam tutorial untuk membuka file yang ditunjuk oleh tautan tersebut di editor Cloud Shell.
<tutorial-editor-open-filefilePath="path/test.md>Buka File</tutorial-editor-open-file>Untuk menambahkan tautan file ke tutorial Anda, simpan file di direktori
$HOMEatau subdirektori dari $HOME. Anda dapat mengaturfilePathdalam instruksi ke jalur absolut atau relatif dari file. Jalur relatif menentukan lokasi file relatif terhadap$HOME.
Kode sampel berikut memberikan contoh cara membuat tutorial. Anda dapat menggunakan editor Vim atau editor Cloud Shell untuk menulis tutorial Anda.
# Gunakan Alibaba Cloud CLI untuk mengelola sumber daya cloud.
## Lihat informasi bantuan Alibaba Cloud CLI.
```bash
aliyun help
```
### Pertama
Catatan
### Selanjutnya
Catatan
```bash
echo world
```
## Selamat! Anda telah menyelesaikan tutorial!
Selamat! Anda telah menyelesaikan tutorial tentang cara menggunakan Alibaba Cloud CLI!Langkah 3: Publikasikan tutorial
Untuk mempublikasikan tutorial, ikuti langkah-langkah berikut:
Sebelum mempublikasikan tutorial, jalankan perintah berikut untuk mengujinya:
teachme tutorial.mdSetelah tutorial Anda lulus pengujian, jalankan perintah git push Cloud Shell untuk mengunggah tutorial Anda dari repositori Git lokal ke repositori Git jarak jauh. Folder tempat Anda menyimpan tutorial adalah repositori Git lokal.
CatatanUnggah tutorial Anda ke repositori jarak jauh yang dapat diakses melalui Internet. Jika tidak, pengguna yang membaca tutorial Anda mungkin tidak dapat mengkloning repositori jarak jauh ke Cloud Shell.