Buat dan publikasikan tutorial interaktif di Cloud Shell untuk membantu pengguna memulai dengan Proyek Anda.
Klik untuk membuka mode tutorial Cloud Shell guna melihat contoh langsung. Dalam mode tutorial, klik perintah apa pun dalam dokumentasi untuk menjalankannya langsung di Cloud Shell.
Langkah 1: Buat file tutorial
-
Di Cloud Shell, buat direktori untuk dokumen tutorial Anda.
Contoh
mkdir tutorials -
Di direktori tersebut, buat file Markdown seperti
tutorial.md.touch tutorial.md
Langkah 2: Tulis tutorial
Tulis tutorial Anda menggunakan sintaks Markdown dan ikuti konvensi berikut:
Gunakan heading H1 (
#) untuk judul tutorial. Setiap dokumen tutorial hanya boleh memiliki satu heading H1.Gunakan heading H2 (
##) untuk judul setiap langkah.-
Tambahkan potongan kode menggunakan sintaks kode Markdown. Cloud Shell akan merendernya sebagai blok kode dengan tombol salin—mengkliknya akan menempelkan perintah langsung ke terminal Cloud Shell.
aliyun help -
Gunakan direktif
<tutorial-nav>untuk menghasilkan struktur navigasi tutorial Anda.<tutorial-nav></tutorial-nav> -
Gunakan direktif
<tutorial-editor-open-file>untuk menambahkan tautan yang membuka file tertentu di editor teks Cloud Shell.<tutorial-editor-open-file filePath="path/test.md">Open File</tutorial-editor-open-file>File tersebut harus berada di direktori
$HOMEatau subdirektorinya. AtributfilePathmenerima jalur mutlak atau jalur relatif. Cloud Shell menyelesaikan jalur relatif relatif terhadap direktori$HOME.
Gunakan contoh berikut sebagai Referensi saat menulis tutorial Anda. Tulis menggunakan perintah vim atau editor teks Cloud Shell.
# Manage cloud resources using Alibaba Cloud CLI
## View Alibaba Cloud CLI help
aliyun help
### First Description
### Then Description
echo world
## Congratulations on completing the tutorial
Congratulations! You have completed the tutorial on how to use Alibaba Cloud CLI.
Langkah 3: Publikasikan tutorial
-
Sebelum menjalankan
git push, pratinjau dan uji tutorial Anda dengan perintah berikut.teachme tutorial.mdshell@Alicloud:~/tutorials$ cat tutorial.md # Manage cloud resources using Alibaba Cloud CLI ## View Alibaba Cloud CLI help aliyun help ### First Description ### Then Description echo world ## Congratulations on completing the tutorial Congratulations! You have completed the tutorial on how to use Alibaba Cloud CLI. shell@Alicloud:~/tutorials$ teachme tutorial.md -
Gunakan perintah Git bawaan di Cloud Shell untuk mendorong tutorial Anda ke repositori Git remote.
CatatanRepositori Git Anda harus bersifat publik. Jika privat, pengguna tidak dapat meng-clone-nya ke Cloud Shell.