Odwrócenie kolejności etykiety i adresu w składni Coyote "[[]]"

0

Propozycja

W składni [[]] umieszcza się tzw. "skrócony adres" treści w Coyote. Dodatkowo po znaku | można dać etykietę, np. [[Pomoc/Różne/Inne|Funkcjonalności nieujęte nigdzie indziej]]. Może można by odwrócić kolejność etykiety i tagu – tak, żeby etykieta była pierwsza?

Zalety, które widzę:

  1. Uspójnienie kolejności ze składnią Markdown [](). W składni Markdown []() etykieta jest pierwsza.
  2. Większa czytelność zdań (podczas edycji danej treści). Gdy użytkownik umieści w zdaniu składnię [[]], to czytając to zdanie, najpierw widzi adres, a potem etykietę. To może przeszkadzać z dwóch powodów:
    1. Adres może "nie mieć wiele wspólnego ze zdaniem", może do niego nie pasować znaczeniowo, semantycznie.
    2. Adres nie jest nigdy odmieniony. Zdanie natomiast może wymagać, żeby w tym miejscu pojawiło się wyrażenie, w którym niektóre lub wszystkie części mowy będą odmienione.

UPDATE Coby łatwiej zobaczyć drugą zaletę, załączam przykładowe zdanie (artykuł Przeglądanie mikroblogów):

W **widoku mikroblogów** użytkownik może przeglądać wpisy na mikroblogach. Widok ten jest dostępny po naciśnięciu przycisku z etykietą "Mikroblogi" w [[Pomoc/Różne/Menu główne serwisu|menu głównym]] Serwisu 4programmers.net (dalej w skrócie: "Serwis").
3

Uspójnienie kolejności ze składnią Markdown

Składnia [[]] jest, zdaje się, kalką z MediaWiki, więc zmiana kolejności oznaczałaby z jednej strony uspójnienie ze składnią Markdown, a z drugiej - rozjazd między składnią MediaWiki; win/lose, jak dla mnie.

Choć rozumiem argumenty, to IMO warto byłoby zostać przy obecnej składni - tego typu migracje bywają nie tylko uciążliwe w implementacji (nikt przecież nie poprawi ręcznie tysięcy artykułów), ale i uciążliwe w odbiorze (użytkownicy już przystosowani do obecnej składni będą musieli się przestawić).

Może gdyby ten wątek powstał kilkanaście lat temu... :-)

0
Patryk27 napisał(a):

Składnia [[]] jest, zdaje się, kalką z MediaWiki, więc zmiana kolejności oznaczałaby z jednej strony uspójnienie ze składnią Markdown, a z drugiej - rozjazd między składnią MediaWiki; win/lose, jak dla mnie.

Dzięki! Nie wiedziałem. Problem można łatwo rozwiązać – jeśli u nas nastąpi zmiana, mogę założyć tam konto (?) i zaproponować podobną zmianę u nich.

(nikt przecież nie poprawi ręcznie tysięcy artykułów)

To teoretycznie racja, z tym że widzę potrzeby poprawy ręcznej. Nie wiem, czy w składni [[]] może być więcej niż jeden znak |. Jeśli nie, to wystarczy automatycznie odwrócić kolejność na tym znaku. Jeśli tak, to mogę poprawić sam wszystkie artykuły, w których będzie składnia z więcej niż jednym znakiem | (jeśli tylko otrzymam ich listę).

użytkownicy już przystosowani do obecnej składni będą musieli się przestawić

Fair enough. Na to nie mam wpływu, to mogłoby zdecydować o odrzuceniu mojej propozycji.

Może gdyby ten wątek powstał kilkanaście lat temu... :-)

;)

UPDATE Ekhm, no, to znaczy, zaproponować na MediaWiki można, ale zmiana może nie przejść tak łatwo jak u nas. Domyślam się, że jest więcej użytkowników ich oprogramowania, a my tylko 1 serwis.

UPDATE Teoretycznie można by dać sobie spokój z tą propozycją i spróbować tak zmienić przynajmniej całą "Pomoc", żeby wszystkie adresy były możliwie najbardziej intuicyjne w kontekście zdań, a co za tym idzie, żeby nie było potrzeby korzystania z etykiety w ogóle. Trudno mi powiedzieć, jak bardzo dałoby się uzyskać zadowalający nas (mnie) efekt.

1

@Patryk27 ma racje. To jest kalka z mediawiki i pochodzi z czasów gdzie nie obsługiwaliśmy markdown. Można powiedzieć że to jest zaszłość, której chętnie bym się pozbył ale zachowana jest ze względu na wsteczną kompatybilność.

0
Adam Boduch napisał(a):

@Patryk27 ma racje. To jest kalka z mediawiki i pochodzi z czasów gdzie nie obsługiwaliśmy markdown. Można powiedzieć że to jest zaszłość, której chętnie bym się pozbył ale zachowana jest ze względu na wsteczną kompatybilność.

OK, "wsteczną kompatybilność", ale czego z czym?

2
Silv napisał(a):
Adam Boduch napisał(a):

@Patryk27 ma racje. To jest kalka z mediawiki i pochodzi z czasów gdzie nie obsługiwaliśmy markdown. Można powiedzieć że to jest zaszłość, której chętnie bym się pozbył ale zachowana jest ze względu na wsteczną kompatybilność.

OK, "wsteczną kompatybilność", ale czego z czym?

No pewnie z tym że w wielu postach i artykułach pewnie jest użyta.

Myślę że jedynym sposobem żeby to naprawić, byłoby napisanie komendy artisanowej w laravelu, ale to nie jest takie proste. Tzn, zrobienie samej komendy jest proste, ale napisanie jej tak żeby nic nie zepsuła wymagałoby wiedzy co się robi.

Ja bym to zrobił tak:

  1. Zrobiłbym fetcha powiedzmy 300-500 postów i kilku artykułów z bazy .net w których wystepuje ciąg [[
  2. Mając takie treści można przystąpić do zimplementowania 'fixera', napisać 10-40 unit testów pod to, i sprawdzać czy komenda faktycznie dobrze update'uje treści. Fixer po prostu parsowałby treść posta, sprawdzał czy jest w nich markup, i jak tak to robił replace'a na link markdown'owy.
  3. Już jest parser który umie parsować te linki, więc dałoby się go użyć do znalezienia wszystkich takich markupów które są uznawane za link do wiki

Ale again, @Silv to jest dużo pracy; i dużo rzeczy może pójść nie tak; należałoby się do tego bardzo dobrze przygotować.

0
TomRiddle napisał(a):
Silv napisał(a):
Adam Boduch napisał(a):

@Patryk27 ma racje. To jest kalka z mediawiki i pochodzi z czasów gdzie nie obsługiwaliśmy markdown. Można powiedzieć że to jest zaszłość, której chętnie bym się pozbył ale zachowana jest ze względu na wsteczną kompatybilność.

OK, "wsteczną kompatybilność", ale czego z czym?

No pewnie z tym że w wielu postach i artykułach pewnie jest użyta.

No tak, ale o rozwiązaniu tego problemu napisałem już wcześniej, dlatego dopytałem Adama. Może nie zauważył, a może chodziło mu o coś innego.

Myślę że jedynym sposobem żeby to naprawić, byłoby napisanie komendy artisanowej w laravelu, ale to nie jest takie proste. Tzn, zrobienie samej komendy jest proste, ale napisanie jej tak żeby nic nie zepsuła wymagałoby wiedzy co się robi.

Ja bym to zrobił tak:

  1. Zrobiłbym fetcha powiedzmy 300-500 postów i kilku artykułów z bazy .net w których wystepuje ciąg [[
  2. Mając takie treści można przystąpić do zimplementowania 'fixera', napisać 10-40 unit testów pod to, i sprawdzać czy komenda faktycznie dobrze update'uje treści. Fixer po prostu parsowałby treść posta, sprawdzał czy jest w nich markup, i jak tak to robił replace'a na link markdown'owy.
  3. Już jest parser który umie parsować te linki, więc dałoby się go użyć do znalezienia wszystkich takich markupów które są uznawane za link do wiki

Ale again, @Silv to jest dużo pracy; i dużo rzeczy może pójść nie tak; należałoby się do tego bardzo dobrze przygotować.

Nie rozumiem. Nie można po prostu odwrócić kolejności na znaku |?

0

Właśnie o tym piszę. Odwróciłoby się kolejność dla każdej istniejącej treści, która zawiera składnię [[]] (posta, komentarza do posta, wpisu, komentarza do wpisu, artykułu, komentarza do artykułu, oferty pracy, komentarza do oferty pracy).

Oczywiście należałoby uwzględnić tylko te treści, w których składnia [[]] jest renderowana do linku, a nie dosłownie np. w elemencie <code>, <pre>.

UPDATE Chociaż w sumie głupotę napisałem. :)

UPDATE2 Moim zdaniem najpierw należy sprawdzić, w ilu treściach występuje ta składnia. Zakładam, że najwięcej jej jest w Kompendium, a w reszcie modułów występuje sporadycznie. Po uzyskaniu tej statystyki można będzie rozważyć, czy gdzieś nie lepiej będzie ręcznie zedytować treść – coby oszczędzić wysiłki i czas przy pisaniu maksymalnie generycznego skryptu.

1 użytkowników online, w tym zalogowanych: 0, gości: 1