Conventii de formatare

Aceasta pagina detaliaza anumite conventii de formatare folosite de echipa infoarena in redactarea paginilor. Se recomanda respectarea cu strictete a acestor indicatii pentru a mentine un look uniform. Orice modificare care se abate de la aceste conventii va fi stearsa.

Corectarea si imbogatirea continutului site-ului este o activitate minutioasa si necesita atentie. Pe pagina asta incercam punem niste reguli fixe pentru ca toata lumea sa stie ce are de facut. Inainte de a citi aceasta pagina cititi bazele sintaxei de textile.

Reguli generale

In cazul ca problema a fost importata de pe infoarena 1.0 veti vedea urmatoarea linie ==Include(page="template/raw")==. Daca nu sunteti multumit de rezultatul final, dar nu mai aveti chef sa editati in continuare, puteti include linia ==Include(page="template/cleanup")==

Cateva reguli scurte si foarte importante:

  • Numele nostru este infoarena, fara liniuta. Se poate folosi scrierea infoarena.
  • Fiecare pagina incepe cu h1. Titlu de pagina.
  • Maxim h3, dar incercati sa va limitati la h2.
  • Url-urile noastre sunt lowercase cu liniuta.
  • Site-ul este in limba romana, inclusiv url-urile.
  • Stirile nu au nevoie de nici un fel de header.
  • Pe infoarena1 se scriau articole cu solutii. Solutiile se muta in pagina-concurs/solutii.
  • Fostele articole trebuie integrate in wiki. Nu mai au autor si nici categorii.

Conventii formatare inline (bold, italic)

Nu folositi bold, italic sau alti modificatori fara un motiv bun. Daca aveti probleme cu inserarea unui anumit caracter puteti consulta aceasta lista si sa folositi direct codul HTML de acolo (spre exemplu pentru ≤ se foloseste ≤, iar pentru √ se foloseste √).

  • Pentru variabile, constante, etc se va folosi $...$ (eg. $7$7).
  • Pentru ridicare se va pune exponentul intre ^...^ (eg. $7^9^$79).
  • Daca nu merg modificatorii inline se folosesc acolade: {$...$} .
  • Daca doriti ca textul dintre modificatori sa nu fie interpretat ca Textile puteti folosi @[email protected] , respectiv {@[email protected] }.
  • Pentru virgula zecimala se va folosi '.'.
  • Pentru numere lungi (eg. 1234567890) este preferata gruparea cifrelor cate 3 pentru baza 10, sau cate 4 pentru bazele 2 si 16. Folositi un singur spatiu pentru despartirea grupelor. Exemple: 1 234 567 890, 10 0010 1101 1011, A4 FAFF A9AB CDC3, 10 333.445 56.

Probleme

Conventiile de formatare a problemelor nu sunt multe dar sunt importante. Va recomandam sa va uitati pe modul de formatarea al problemelor deja existente in arhiva pentru a vedea cum sunt aplicate. In cele ce urmeaza le vom lista pe cele mai importante:

  • Numerele, constantele, variabilele, expresiile, numele fisierelor de intrare/iesire sunt inconjurate de $...$ indiferent de pozitia lor in text! Exceptie fac testele, unde nu trebuie sa folositi dolari: table(example) isi face singur treaba.
  • Pastrati structura unui task (vedeti paragraful urmator)!
  • Corect este "Date de intrare"/"Date de iesire"! De exemplu, evitati sa scrieti "Date de Iesire".
  • Precizarile care sunt propozitii incep cu litera mare si se termina cu punct. La fel si explicatiile.
  • Asigura-te ca titlul problemei (completat in prima casuta din modul "Editeaza") este scris cu litera mare.
  • In unele cazuri apar $ nedoriti in textul final. Dati un search la sfarsit in textul problemei (asa cum este el vazut de utilizator) si verificati ca acest lucru nu se intampla.

Acceseaza template-ul pentru a vedea structura generala a unui task in cod Textile. Structura unui task este urmatoarea:

  • Header: ==Include(page="template/taskheader" task_id="nume_task")==
  • Enunt: Povestea problemei.
  • Date de intrare.
  • Date de iesire.
  • Restrictii: Se pun intr-o lista cu *.
  • Exemple: un tabel textila cu clasa de css example. Vezi mai jos
  • Footer: ==Include(page="template/taskfooter" task_id="nume_task")==
  • Macro cu topic-ul din forum

Exemplele se pun intr-un tabel formatat similar celui din template. Prima coloana a tabelului va fi formatata in felul urmator:

table(example). |_. task_id.in |_. task_id.out |
unde task_id reprezinta id-ul taskului editat.

Pentru coloane aditionale veti adauga in continuare _. nume_coloana | de cate ori este necesar. Fiecare din liniile de tabel ce urmeaza se va reprezenta pe coloane, fiecare celula fiind separata prin pipe |:

| coloana 1 | coloana 2 | coloana 3 | coloana 4 |

Se pot introduce mai multe linii intr-o singura celula a tabelului folosind, evident, new line. Daca doriti sa introduceti linii goale in tabel folositi  . Se recomanda ca explicatiile exemplelor sa fie incluse separat, imediat sub tabelul cu exemple, folosind un titlu h3: h3. Explicatii

Concursuri

Vezi pagina de concursuri.