FastComments.com

Sintaksa komentarjev

Tukaj bomo obravnavali format komentarjev FastComments, funkcije, ki so podprte pri pisanju komentarjev, kako oblikovati besedilo ter različne filtre in varnostne ukrepe, vgrajene v sistem.

Osnovno oblikovanje Internal Link

FastComments uporablja kombinacijo Markdowna in preprostega podmnožja HTML-ja za omogočanje pisanja komentarjev.

Dober vir za sintakso Markdown je tukaj.

Za najpogostejše oblikovanje lahko uporabite orodno vrstico za oblikovanje za stvari, kot sta krepko ali poševno besedilo.

Nekaj primerov sintakse:

  • Krepko:
    • **krepko**
    • <b>krepko besedilo</b>
  • Poševno:
    • *poševno*
    • <i>poševno besedilo</i>
  • Prečrtano:
    • ~~prečrtano~~
    • <strike>prečrtano</strike>
  • Citati:
    • > citat

Upoštevajte, da naslovi Markdown niso podprti.

Povezave se lahko napišejo kot surov URL, brez HTML-ja ali druge sintakse, in privzeto bo povezava pretvorjena v klikljivo povezavo s target="nofollow noopener" za odvračanje pošiljateljev neželene pošte. Nekatera spletna mesta se lahko odločijo onemogočiti samodejno ustvarjanje povezav.

Oštevilčene sezname lahko napišete tako:

1. Prva postavka.
2. Druga postavka.
3. Tretja postavka.

Enako velja za označene sezname:

- Neka točka.
- Neka druga točka.

Za skupnosti, usmerjene v programiranje, se koda lahko deli z lepljenjem v območje komentarjev, jezik pa bo samodejno zaznan in oblikovan. Kodo lahko dodate v oznake <code></code> ali bloke kode Markdown z obrnjenim narekovajem.

Varnost Internal Link

Omogočanje uporabnikom dodajanja vsebine na spletno stran in nato prikaz te vsebine na številnih različnih vrstah naprav prinaša več vidikov varnosti.

Preprečevanje zlorabe oblikovanja

Ljudje lahko pišejo vsebino, ki je namenoma vizualno moteča in odvreda vrednost razprav, z zlorabo oblikovanja besedila.

FastComments naredi več stvari za preprečevanje zlorabe v zvezi z oblikovanjem:

  • Velike ponavljajoče se zaporedne prelome vrstic se strnejo.
  • Naslovov ne prikazujemo (postanejo običajno besedilo).
  • CSS ali barv po meri ne dovoljujemo.

Preprečevanje izkoriščanja ranljivosti

Izkoriščanja ranljivosti lahko nastanejo v sistemih, ki prikazujejo HTML. FastComments naredi več stvari za preprečevanje tega:

  • Dovoljujemo samo izrecno določen nabor oznak HTML.
  • Dovoljujemo samo izrecno določen nabor atributov oznak HTML.
  • Vse vnose očistimo in sanitiziramo.
    • To naredimo s knjižnicama DOMPurify in sanitizeHtml.
    • Izbrali smo ti knjižnici, ker sta dobro preizkušeni (vsaka ima več kot 4 oziroma 1 milijon prenosov na teden).

To pomeni, da uporabniki ne morejo početi stvari, kot je pisanje oznak <script> ali <style>, ali poskus dodajanja skript vrste onload=alert() slikam ali drugi vsebini.

Oznake HTML, ki jih dovoljujemo, so naslednje:

  • <b>
  • <em>
  • <u>
  • <i>
  • <strike>
  • <pre>
  • <span>
  • <code>
  • <img>
  • <a>
  • <strong>
  • <ul>
  • <ol>
  • <li>
  • <br>

Oznaka <iframe> privzeto ni dovoljena. Če vklopite možnost Allow Media Embeds, so iframi prav tako dovoljeni, vendar le, kadar je njihov vir en od vgrajenega seznama zaupanja vrednih ponudnikov (kot so YouTube, Vimeo, SoundCloud in Spotify) ali gostiteljsko ime, ki ste ga izrecno dodali. Iframi iz katerega koli drugega vira so odstranjeni.