Jak przecenić zagnieżdżone elementy listy w Bitbucket?

173

Próbuję zobaczyć moje zagnieżdżone elementy listy z przeceną, renderowane z odpowiednim wcięciem, gdy są wyświetlane w przeglądarce na żywo ze stron Bitbucket. Ale nie mogę zrozumieć, jak to działa, nawet używając ich przykładów ( zaktualizowanych ):

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

Ignoruje wcięcia dla pozycji 3a-c:

lista renderowana przez bitbucket

Chcę, żeby wyglądało to tak (składnia działa doskonale na SE i Github):

Lista renderowana przez SE

Ich lista w przykładzie listy jest szczególnie niedopuszczalna:

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

lista na liście na bb

Oto repozytorium, które skonfigurowałem właśnie w tym celu.

Jeff Puckett
źródło
6
Czy wcięcie o cztery spacje? Lub mniej?
Waylan

Odpowiedzi:

277

Użyj 4 spacji.

# 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

Oto zrzut ekranu z tego zaktualizowanego repozytorium:

zrzut ekranu

Dzięki @Waylan , twój komentarz był dokładnie poprawny .

Jeff Puckett
źródło
4
Warto również wspomnieć, że w niektórych przypadkach dobrą praktyką jest nie numerowanie list. Jeśli mają być czytane tylko w postaci renderowanej, użyj „1”. dla każdego elementu spowoduje ich automatyczne numerowanie. Należy tego unikać, jeśli starasz się zachować czytelność tekstu.
Nilpo
1
Czy jest jakiś powód, dla którego linters zaczynają sugerować 2 spacje dla zawartości listy zagnieżdżonej?
Greg Hilston
Nie mogłem dowiedzieć się, jak to zrobić w nowym edytorze Atlassian, który są wdrażane w Laboratorium. confluence.atlassian.com/doc/the-editor-251006017.html Ale może to jest odpowiedź? confluence.atlassian.com/doc/…
Ryan
niektóre implementacje używają czterech spacji dla bloków kodu, więc nie można ich użyć do zagnieżdżania
Pablo Pazos,
2
@PabloPazos to pytanie dotyczy konkretnie implementacji Bitbucket, której prawdopodobnie brakuje.
Jeff Puckett
4

Możliwości

  • Możliwe jest zagnieżdżenie listy wypunktowanej nienumerowanej na liście o wyższym numerze.
  • Ale na liście punktowanej-nienumerowanej lista automatycznie numerowana nie rozpocznie się: nie jest obsługiwana.
    • Aby rozpocząć nową listę numerowaną po liście wypunktowanej-nienumerowanej, umieść między nimi fragment tekstu lub podtytuł: Nowa lista numerowana nie może zaczynać się tuż za wypunktowaną: Tłumacz nie rozpocznie numeracji.

w praktyce

  1. Pies

    1. Owczarek niemiecki - tylko o jedno miejsce przed.
    2. Owczarek Belgijski - maksymalnie 4 pola przed.
      • Liczba przed wierszem zinterpretowana jako „punktor numeracji”, a więc utworzenie wcięcia.
        • ..i ignoruje zapisaną cyfrę: umieszcza / generuje własną, zgodnie ze strukturą.
        • Więc jest OK, aby użyć tylko "1", aby otrzymać listę numerowaną.
          • Lub jakakolwiek liczba całkowita, nawet więcej cyfr: Numeracja listy będzie kontynuowana z przyrostem ++ 1.
        • Jednak pierwsza pozycja na liście numerowanej zostanie zachowana, więc pierwszą interlinią będzie zazwyczaj liczba „1”.
    3. Malinois - 5 pól to już 3 poziom.
      1. MalinoisB - 5 miejsc to już trzeci poziom.
      2. Groenendael - 8 pól to jeszcze trzeci poziom.
        1. Tervuren - 9 miejsc na 4 poziom - celowo rozpoczęto od „55”.
        2. TervurenB - numerowane „88” w kodzie źródłowym.
  2. Kot

    1. Syberyjski; za. SyberyjskiA - problem powielony : litery (tu „a”) nie są rozpoznawane przez tłumacza jako „numeracja”.
      • Nie ma znaczenia, jest wcięty w oddzielnym wierszu w kodzie źródłowym.
    2. syjamski
      • za. więc napisane ręcznie jako obejście niewłaściwego użycia punktorów, nienumerowana lista.
Franta
źródło
0

4 spacje załatwiają sprawę nawet wewnątrz listy definicji:

Endpoint
: `/listAgencies`

Method
: `GET`

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

Dokumentuję API za pomocą BitBucket Wiki i zastrzeżonego rozszerzenia Markdown dla listy definicji jest najbardziej przyjemne (składnia tabeli MD jest okropna, obrazowanie wielowierszowe i wymagania dotyczące osadzania ...).

gavenkoa
źródło
-6

Działa nawet jedna przestrzeń

... Po prostu otwórz tę odpowiedź do edycji, aby ją zobaczyć.

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

Listy zagnieżdżone, głębsze poziomy:

  • element pierwszego poziomu A - bez spacji przed znakiem punktora
    • przedmiot Aa drugiego poziomu - wystarczy 1 miejsce
      • przedmiot trzeciego poziomu Aaa - 5 spacji min
    • element Ab drugiego poziomu - możliwe również 4 miejsca
  • element pierwszego poziomu B.

    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
źródło
1
Jedno miejsce to za mało na drugim poziomie
JGallardo
„Jedno miejsce to za mało na drugim poziomie” .. O czym ty mówisz, @JGallardo? Przygotowałem praktyczne zastosowanie, które pokazuje, że to naprawdę działa. Dlaczego w odpowiedzi przedstawiłem kod źródłowy? .. Po prostu zobacz to sam: otwórz go do edycji. (ale nie zmieniaj tego, proszę.)
Franta
Zobacz podobny temat i moją odpowiedź tam: Całkiem to samo, skopiuj / wklej. meta.stackexchange.com/a/325252/361135
Franta
3
Jasne, w tym edytorze to działa, ale pytanie dotyczy BitBucketa i tam nie działało. Przynajmniej nie wtedy, gdy ostatnio sprawdzałem w czerwcu 2019 r. Być może tak było, kiedy pisałeś oryginalną odpowiedź, ale nie zgodnie z moją obecną wiedzą.
JGallardo