Sivu 1/2

Markdown -tuki (litedown ja PipeTables)

Lähetetty: 15 Tammi 2021, 22:14
Kirjoittaja janx

Markdown -tuki lisättiin komitean järkkäämässä päivityksessä foorumille. Se on kevyt ja yksinkertainen merkkauskieli, joka käännetään haluttuun muotoon esim. html:ksi. Markdownkoodi käännetään litedown-kääntäjällä viestiä lähettäessä. PipeTables kääntää taulukot. Markdown on oletuksena kaikilla käytössä.

Foorumin oletusmerkkauksella BBCodella pärjää oikein hyvin ja sen käyttöä voikin pitää ensisijaisesti suositeltavana, mutta etenkin pidemmissä dokumenteissa markdown helpottaa ylläpitoa.

Tuki on toteutettu phpBB-foorumille tarkoitetulla laajennoksella, josta lisätietoja: https://www.phpbb.com/customise/db/extension/markdown/

Litedownin tulkinnat markdown-merkkauksista löytyvät täältä: https://s9etextformatter.readthedocs.io ... wn/Syntax/

Hyödylliset merkkaukset foorumilla (ehkä)

Sisäinen linkki viestin tiettyyn kohtaan

A
<< Tämän ei kuulukaan näkyä paitsi lähdekoodissa

Koodi: Valitse kaikki

[A](#a)
[](#a) << Tämän ei kuulukaan näkyä paitsi lähdekoodissa

Vaakasuuntaiset erotteluviivat






Koodi: Valitse kaikki

* * *
***
*****
- - -
---------------------------------------

Numeroimaton listat

  • Pelkkä viiva
  • antaa numeroimattoman
  • listan
  • Listat toimivat edelleen myös BBCode-muodossa!

Numeroitu lista

  1. Numero kirjoitettuna
  2. antaa numeroidun
  3. listan

Koodi: Valitse kaikki

**Numeroimaton listat**
- Pelkkä viiva 
- antaa numeroimattoman 
- listan
- Listat toimivat edelleen myös BBCode-muodossa!

**Numeroitu lista**
1. Numero kirjoitettuna 
2. antaa numeroidun 
3. listan

Ala- ja yläindeksi
x2
x2
xn - 1
xn2
xn2
H2O
H2O

Koodi: Valitse kaikki

x^2
x^2^
x^(n - 1)
x^(n^2)
x^(n^(2))
H~2~O
H~(2)O

Taulukot
Ensimmäinen taulukko toimii myös tekstimuotoisena. Toinen merkkausmuoto on mahdollisimman vähämerkkinen tapa tehdä taulukko, jota esim. itse suosin. Viimeisessä taulukossa voi tehdä tekstin sijoitelua vasemmalle, keskelle tai oikeaan reunaan. Se toimii myös vähämerkkisessä tavassa.

Header 1Header 2
Cell 1Cell 2

Koodi: Valitse kaikki

| Header 1 | Header 2 |
|----------|----------|
| Cell 1   | Cell 2   |

tai yksinkertaisemmalla merkintätavalla

Koodi: Valitse kaikki

Header 1|Header 2
-|-
Cell 1|Cell 2
LeftCenterRight
xxx

Kaksoispisteen avulla voit määritellä miten teksti tasataan.

Koodi: Valitse kaikki

| Left | Center | Right |
|:-----|:------:|------:|
|   x  |    x   |   x   |

Se toimii myös yksinkertaisella merkintätavalla.

Koodi: Valitse kaikki

Left|Center|Right
-|:-:|-:
x|x|x

Re: Markdown -tuki (litedown ja PipeTables)

Lähetetty: 16 Tammi 2021, 10:05
Kirjoittaja jori

Onko tuossa nyt sitten sekaisin kolmea erilaista koodia, vai miksi on samalle tulokselle useita tapoja tehdä? :?


Re: Markdown -tuki (litedown ja PipeTables)

Lähetetty: 16 Tammi 2021, 14:01
Kirjoittaja janx
jori kirjoitti: 16 Tammi 2021, 10:05

Onko tuossa nyt sitten sekaisin kolmea erilaista koodia, vai miksi on samalle tulokselle useita tapoja tehdä? :?

Samasta syystä kun on nojapyöräilyssä useita eri tapoja tehdä nojapyöräilyä. :) Kaikki koodit tosiaan poikkeavat toisistaan. Ensimmäinen taulukko toimii myös tekstimuotoisena. Toinen merkkausmuoto on mahdollisimman vähämerkkinen tapa tehdä taulukko, jota esim. itse suosin. Viimeisessä taulukossa voi tehdä tekstin sijoitelua vasemmalle, keskelle tai oikeaan reunaan. Se toimii myös vähämerkkisessä tavassa.


Re: Markdown -tuki (litedown ja PipeTables)

Lähetetty: 16 Tammi 2021, 15:32
Kirjoittaja jori
janx kirjoitti: 16 Tammi 2021, 14:01
jori kirjoitti: 16 Tammi 2021, 10:05

Onko tuossa nyt sitten sekaisin kolmea erilaista koodia, vai miksi on samalle tulokselle useita tapoja tehdä? :?

Samasta syystä kun on nojapyöräilyssä useita eri tapoja tehdä nojapyöräilyä. :) Kaikki koodit tosiaan poikkeavat toisistaan. Ensimmäinen taulukko toimii myös tekstimuotoisena. Toinen merkkausmuoto on mahdollisimman vähämerkkinen tapa tehdä taulukko, jota esim. itse suosin. Viimeisessä taulukossa voi tehdä tekstin sijoitelua vasemmalle, keskelle tai oikeaan reunaan. Se toimii myös vähämerkkisessä tavassa.

Olisiko nuo eri tavat voinut nimetä ja myös lisätä tuon perustelun tuohon alkuperäiseen viestiin jossa asia selostetaan, vai olinko minä tosiaan ainoa, joka ei ymmärtänyt sitä tuon viestin perusteella. – Jos olin ainoa, ei sitä tarvitse korjata.


Re: Markdown -tuki (litedown ja PipeTables)

Lähetetty: 16 Tammi 2021, 16:09
Kirjoittaja PW
jori kirjoitti: 16 Tammi 2021, 15:32
janx kirjoitti: 16 Tammi 2021, 14:01
jori kirjoitti: 16 Tammi 2021, 10:05

Onko tuossa nyt sitten sekaisin kolmea erilaista koodia, vai miksi on samalle tulokselle useita tapoja tehdä? :?

Samasta syystä kun on nojapyöräilyssä useita eri tapoja tehdä nojapyöräilyä. :) Kaikki koodit tosiaan poikkeavat toisistaan. Ensimmäinen taulukko toimii myös tekstimuotoisena. Toinen merkkausmuoto on mahdollisimman vähämerkkinen tapa tehdä taulukko, jota esim. itse suosin. Viimeisessä taulukossa voi tehdä tekstin sijoitelua vasemmalle, keskelle tai oikeaan reunaan. Se toimii myös vähämerkkisessä tavassa.

Olisiko nuo eri tavat voinut nimetä ja myös lisätä tuon perustelun tuohon alkuperäiseen viestiin jossa asia selostetaan, vai olinko minä tosiaan ainoa, joka ei ymmärtänyt sitä tuon viestin perusteella. – Jos olin ainoa, ei sitä tarvitse korjata.

Pahasti menee koko asia yli hilseen mutta se ei liene kohdallani ihme kun kyseessä lienee atk.


Re: Markdown -tuki (litedown ja PipeTables)

Lähetetty: 16 Tammi 2021, 18:27
Kirjoittaja janx
jori kirjoitti: 16 Tammi 2021, 15:32

Olisiko nuo eri tavat voinut nimetä ja myös lisätä tuon perustelun tuohon alkuperäiseen viestiin jossa asia selostetaan, vai olinko minä tosiaan ainoa, joka ei ymmärtänyt sitä tuon viestin perusteella. – Jos olin ainoa, ei sitä tarvitse korjata.

Olisi varmaan. Sitä kun itse lukee koodia (ja sen kommentteja) eikä selostuksia, niin tuppaa helposti jäämään asioita pois, joita ei osaa edes ajatella, että ne pitäisi kirjoittaa auki. Tässähän näitä kehitetään ymmärrettävään muotoon. Jos ei tee mitään, ei synny mitään - edes virheitä. Jos laittaa siemen multaan, siitä voi yhteispelillä tulla puu. Jos henkilö x kirjoittaa ohjeistuksen henkilölle y, tarvitaan yleensä vielä n+1 kpl lisäyksiä ja korjauksia, että y sen todella ymmärtää.


Re: Markdown -tuki (litedown ja PipeTables)

Lähetetty: 16 Tammi 2021, 22:53
Kirjoittaja jori
janx kirjoitti: 16 Tammi 2021, 18:27
jori kirjoitti: 16 Tammi 2021, 15:32

Olisiko nuo eri tavat voinut nimetä ja myös lisätä tuon perustelun tuohon alkuperäiseen viestiin jossa asia selostetaan, vai olinko minä tosiaan ainoa, joka ei ymmärtänyt sitä tuon viestin perusteella. – Jos olin ainoa, ei sitä tarvitse korjata.

Olisi varmaan. Sitä kun itse lukee koodia (ja sen kommentteja) eikä selostuksia, niin tuppaa helposti jäämään asioita pois, joita ei osaa edes ajatella, että ne pitäisi kirjoittaa auki. Tässähän näitä kehitetään ymmärrettävään muotoon. Jos ei tee mitään, ei synny mitään - edes virheitä. Jos laittaa siemen multaan, siitä voi yhteispelillä tulla puu. Jos henkilö x kirjoittaa ohjeistuksen henkilölle y, tarvitaan yleensä vielä n+1 kpl lisäyksiä ja korjauksia, että y sen todella ymmärtää.

Tähän laittaisin someprotokollan mukaisesti peukun kuvan. Koska sitä ei ole tarjolla, kirjoitan sen: PEUKKU
Tuli vieläpä iso peukku. :D


Re: Markdown -tuki (litedown ja PipeTables)

Lähetetty: 17 Tammi 2021, 22:45
Kirjoittaja Härski

Ihan puutaheinää tommoset jutut on tavan ihmiselle, millä ajatukset on jossain muualla kun bittimaailmassa. :D


Re: Markdown -tuki (litedown ja PipeTables)

Lähetetty: 20 Tammi 2021, 19:18
Kirjoittaja janx
Härski kirjoitti: 17 Tammi 2021, 22:45

Ihan puutaheinää tommoset jutut on tavan ihmiselle, millä ajatukset on jossain muualla kun bittimaailmassa. :D

Ainakin kehittäjät ovat yrittäneet. :) Tuosta kun mennään vielä yksinkertaisemmaksi alkaa luettavuus kärsiä ihan todenteolla.

Its key design goal is readability – that the language be readable as-is, without looking like it has been marked up with tags or formatting instructions (Tärkein suunnittelutavoite on ollut luettavuus. Kieli olisi luettavissa sellaisenaan ilman, että se olisi merkitty tunnisteilla tai muotoiluohjeilla.)

Lähde: https://en.wikipedia.org/wiki/Markdown#History


Re: Markdown -tuki (litedown ja PipeTables)

Lähetetty: 22 Tammi 2021, 09:08
Kirjoittaja PW

Olisiko nyt mahdollista esimerkiksi kinnerirekisteri muokata taulukkomuotoon tällä otsikon systeemillä?


Re: Markdown -tuki (litedown ja PipeTables)

Lähetetty: 22 Tammi 2021, 09:48
Kirjoittaja jori
PW kirjoitti: 22 Tammi 2021, 09:08

Olisiko nyt mahdollista esimerkiksi kinnerirekisteri muokata taulukkomuotoon tällä otsikon systeemillä?

Jo toki on mahdollista. Tässähän on erinomainen paikka osoittaa Markdownin kynnet. Kuka tekee? Tässä linkki kinnerirekisteriviestiin. viewtopic.php?p=59148#p59148


Re: Markdown -tuki (litedown ja PipeTables)

Lähetetty: 23 Tammi 2021, 13:40
Kirjoittaja janx
PW kirjoitti: 22 Tammi 2021, 09:08

Olisiko nyt mahdollista esimerkiksi kinnerirekisteri muokata taulukkomuotoon tällä otsikon systeemillä?

Tekisin sen näin. Tässä muutama esimerkkirivi.

Helsingin seutu

Nimi tai nimimerkkiAjoneuvoLisätietoja
TJTMango-
TMSDFXLkevät -16
VelowagonHilgovalk 04/19
ajarmalaMilankeltainen
ajouArcusoma/suomalainen valmiste, keltainen
KinneriLeitrakeltainen

Koodi: Valitse kaikki

### Helsingin seutu
Nimi tai nimimerkki | Ajoneuvo | Lisätietoja
-|-|:-
TJT | Mango | -
TMS | DFXL | kevät -16
Velowagon | Hilgo | valk 04/19
ajarmala | Milan | keltainen
ajou | Arcus | oma/suomalainen valmiste, keltainen
Kinneri | Leitra | keltainen

Edit: Harkitsemisen arvoinen lisä voisi olla linkki esim. foorumin ketjuun, kuvaan tai vaikka valmistajan sivulle. Se toki lisää naputtelun määrää.


Re: Markdown -tuki (litedown ja PipeTables)

Lähetetty: 23 Tammi 2021, 14:34
Kirjoittaja PW

En vieläkään ymmärrä, onko taulukko kenen tahansa foorumilaisen mahollista tehdä (jos osaa) vai pitääkö olla mode tai joku muu?


Re: Markdown -tuki (litedown ja PipeTables)

Lähetetty: 23 Tammi 2021, 16:43
Kirjoittaja janx
PW kirjoitti: 23 Tammi 2021, 14:34

En vieläkään ymmärrä, onko taulukko kenen tahansa foorumilaisen mahollista tehdä (jos osaa) vai pitääkö olla mode tai joku muu?

Kokeile. Markdown on kaikkien käytössä. Ohjelma luo taulukon koodin perusteella. Kyse on vain viestin muotokielestä, jota kääntäjä tulkitsee.


Re: Markdown -tuki (litedown ja PipeTables)

Lähetetty: 23 Tammi 2021, 17:03
Kirjoittaja PW
janx kirjoitti: 23 Tammi 2021, 16:43
PW kirjoitti: 23 Tammi 2021, 14:34

En vieläkään ymmärrä, onko taulukko kenen tahansa foorumilaisen mahollista tehdä (jos osaa) vai pitääkö olla mode tai joku muu?

Kokeile. Markdown on kaikkien käytössä. Ohjelma luo taulukon koodin perusteella. Kyse on vain viestin muotokielestä, jota kääntäjä tulkitsee.

Niet bonimaju :? Ei mitään käryy på finska :?