Bagaimana cara menandai item daftar bersarang di Bitbucket?

173

Saya mencoba untuk melihat item daftar bersarang penurunan harga saya yang diberikan dengan indentasi yang sesuai ketika dilihat di browser langsung dari halaman Bitbucket. Tapi saya tidak tahu bagaimana cara kerjanya bahkan ketika menggunakan contoh mereka ( diperbarui ):

* Item 1
* Item 2
* Item 3
  * Item 3a
  * Item 3b
  * Item 3c

Mengabaikan lekukan untuk item 3a-c:

daftar yang diberikan bitbucket

Saya ingin tampilannya seperti ini (sintaks berfungsi dengan baik pada SE dan Github):

Daftar yang diberikan SE

Daftar mereka dalam contoh daftar sangat tidak dapat diterima:

1. Step 1
2. Step 2
3. Step 3
   * Item 3a
   * Item 3b
   * Item 3c

daftar dalam daftar di bb

Inilah repo yang saya atur hanya untuk ini.

Jeff Puckett
sumber
6
Apakah Anda membuat indentasi dengan empat spasi? Atau kurang?
Waylan

Jawaban:

279

Gunakan 4 spasi.

# Unordered list

* Item 1
* Item 2
* Item 3
    * Item 3a
    * Item 3b
    * Item 3c

# Ordered list

1. Step 1
2. Step 2
3. Step 3
    1. Step 3.1
    2. Step 3.2
    3. Step 3.3

# List in list

1. Step 1
2. Step 2
3. Step 3
    * Item 3a
    * Item 3b
    * Item 3c

Berikut screenshot dari repo yang diperbarui:

tangkapan layar

Terima kasih @Waylan , komentar Anda tepat.

Jeff Puckett
sumber
4
Perlu juga disebutkan bahwa adalah praktik yang baik untuk tidak memberi nomor pada daftar Anda dalam beberapa kasus. Jika mereka hanya dimaksudkan untuk membaca dalam bentuk yang diberikan, menggunakan "1." untuk setiap item akan menyebabkan mereka diberi nomor otomatis. Ini harus dihindari jika Anda mencoba mempertahankan keterbacaan teks.
Nilpo
1
Ada alasan mengapa linter mulai menyarankan 2 spasi untuk konten daftar bersarang?
Greg Hilston
Saya tidak tahu bagaimana melakukannya di Editor Atlassian baru yang mereka buat di Labs. confluence.atlassian.com/doc/the-editor-251006017.html Tapi mungkin ini jawabannya? confluence.atlassian.com/doc/...
Ryan
beberapa implementasi menggunakan empat ruang untuk blok kode sehingga ini tidak dapat digunakan untuk bersarang
Pablo Pazos
2
@PabloPazos pertanyaan ini secara khusus tentang implementasi Bitbucket, yang bisa dibilang ingin.
Jeff Puckett
4

Kemungkinan

  • Dimungkinkan untuk menyarangkan daftar berpoin-tidak bernomor ke daftar bernomor yang lebih tinggi.
  • Tetapi dalam daftar berpoin-tidak bernomor, daftar bernomor otomatis tidak akan mulai: Tidak didukung.
    • Untuk memulai daftar bernomor baru setelah yang tidak diberi nomor bullet, letakkan selembar teks di antara mereka, atau subtitle: Daftar bernomor baru tidak dapat memulai tepat di belakang bullet: Penerjemah tidak akan memulai penomoran.

dalam praktek

  1. Anjing

    1. Gembala Jerman - dengan hanya satu ruang di depan.
    2. Gembala Belgia - maksimal 4 ruang di depan.
      • Angka di depan garis diartikan sebagai "peluru penomoran", sehingga membuat lekukan.
        • ..dan mengabaikan digit tertulis: Tempat / menghasilkan sendiri, sesuai dengan struktur.
        • Jadi tidak apa-apa menggunakan hanya "1" saja, untuk mendapatkan daftar bernomor Anda.
          • Atau bilangan integer apa pun, bahkan lebih banyak digit: Penomoran daftar akan dilanjutkan dengan kenaikan ++ 1.
        • Namun, item pertama dalam daftar bernomor akan disimpan, sehingga yang pertama memimpin biasanya adalah nomor "1".
    3. Malinois - 5 spasi membuat level 3 sudah.
      1. MalinoisB - 5 spasi membuat level 3 sudah.
      2. Groenendael - 8 spasi membuat level ke-3 juga.
        1. Tervuren - 9 spasi untuk level 4 - Intentionaly dimulai oleh "55".
        2. TervurenB - dinomori oleh "88", dalam kode sumber.
  2. Kucing

    1. Siberia; Sebuah. SiberianA - masalah direproduksi : huruf (yaitu "a" di sini) tidak diakui oleh penerjemah sebagai "penomoran".
      • Tidak masalah, itu indent ke baris yang dipisahkan, dalam kode sumber.
    2. Siam
      • Sebuah. jadi ditulis secara manual sebagai solusi menyalahgunakan peluru, daftar tidak bernomor.
Franta
sumber
0

4 ruang melakukan trik bahkan di dalam daftar definisi:

Endpoint
: `/listAgencies`

Method
: `GET`

Arguments
:   * `level` - bla-bla.
    * `withDisabled` - should we include disabled `AGENT`s.
    * `userId` - bla-bla.

Saya mendokumentasikan API menggunakan BitBucket Wiki dan ekstensi kepemilikan Markdown untuk daftar definisi sangat menyenangkan (sintaksis tabel MD mengerikan, pencitraan multiline dan persyaratan penyematan ...).

gavenkoa
sumber
-6

Bahkan satu ruang saja berfungsi

... Buka saja jawaban ini untuk diedit untuk melihatnya.

Nested lists, deeper levels: ---- leave here an empty row * first level A item - no space in front the bullet character * second level Aa item - 1 space is enough * third level Aaa item - 5 spaces min * second level Ab item - 4 spaces possible too * first level B item

Daftar bersarang, level yang lebih dalam:

  • level pertama Item - tidak ada ruang di depan karakter bullet
    • level kedua item Aa - 1 ruang sudah cukup
      • tingkat ketiga Aaa item - 5 spasi min
    • item Ab level kedua - 4 spasi mungkin juga
  • item tingkat B pertama

    Nested lists, deeper levels:
     ...Skip a line and indent eight spaces. (as said in the editor-help, just on this page)
    * first level A item - no space in front the bullet character
     * second level Aa item - 1 space is enough
         * third level Aaa item - 5 spaces min
        * second level Ab item - 4 spaces possible too
    * first level B item
    
Franta
sumber
1
Satu ruang tidak cukup di lantai dua
JGallardo
"Satu ruang tidak cukup di lantai dua" .. Apa yang kamu bicarakan, @JGallardo? Saya sudah menyiapkan penggunaan praktis, yang menunjukkan, bahwa itu benar-benar berfungsi. Bagaimana saya menyajikan kode sumber, dalam jawaban saya? ..Cukup melihatnya sendiri: Buka untuk diedit. (tapi jangan mengubahnya, tolong.)
Franta
Lihat topik serupa dan jawaban saya di sana: Sama, salin / tempel. meta.stackexchange.com/a/325252/361135
Franta
3
Tentu dalam editor ini ini berfungsi tetapi pertanyaannya adalah tentang BitBucket dan tidak berfungsi di sana. Setidaknya tidak ketika saya terakhir memeriksa pada Juni 2019. Mungkin dulu ketika Anda menulis jawaban asli, tetapi tidak yang terbaik dari pengetahuan saya saat ini.
JGallardo