description |
---|
Ești interesat să îți împărtășești cunoștințele cu colegii tăi? Află de aici cum poți începe să contribui! |
Deoarece dorim ca educația de calitate să fie valabilă oricum, vrem să oferim șansa tuturor să își împărtășească cunoștințele!
{% hint style="warning" %}
Poți contribui prin GitHub! Mergi direct la secțiunea GitHub _**_ca să afli mai multe. {% endhint %}
Înainte să îți creezi un nou fișier ai nevoie de template-ul oficial pe care lucrăm. Template-ul conține un footer standard, în care va trebui să îți introduci datele de contact (email, Facebook, etc.). Orice cititor care nu înțelege ceva va avea nevoie de sprijin.
Așadar, considerăm că intră în atribuțiile autorilor să ajute cititorii în momentul în care ei nu înțeleg ceva și au nevoie de ajutor. De asemenea, dacă nu doriți să fiți contactați, atunci va trebui să explicați foarte bine 😉
După ce ai descărcat template-ul (nu-l modifica!) intri laNew > Import > Browse/Drag & Drop
și selectezi fișierul Template.md
.
GitBook oferă un editor de text vizual, puternic și foarte ușor de folosit.
În următoarele secțiuni, este descris pe scurt flow-ul de editare de conținut pe GitBook. Conținutul din aceste secțiuni a fost preluat în mare parte din documentația GitBook.
{% hint style="info" %} Poți accesa modul de editare apăsând pe iconița ✏️ din sidebar 👈. {% endhint %}
Principalele fișiere în care se lucrează sunt draft-urile. Acestea sunt vizivile numai de restul colaboratorilor/autorilor.
Modificările făcute într-un draft sunt izolate pe acel draft. Adică dacă 2 sau mai multe persoane lucrează pe același document, puteți salva fiecare draft-urile lui fără să apară conflicte. Atenție totuși, atunci când faceți merge iar între timp a făcut și altă persoană merge, vor apărea conflicte deoarece voi nu veți avea modificările celeilalte persoane. Din fericire, GitBook oferă ajutor vizual în rezolvarea conflictelor!
{% hint style="info" %} 🧙 Tip: Dă o denumire fiecărui draft pe care lucrezi. Acesta te va ajuta și pe tine, dar și pe restul colaboratorilor în a ști despre ce e vorba în document. {% endhint %}
Prima variantă a unui draft cel mai probabil nu va fi nici varianta finală. Folosește funcția "save" și vei putea continua lucrul mai târziu sau se va putea uita și altcineva să îți dea feedback.
{% hint style="info" %} 🧙 Tip: 📝Poți da "save" apăsând ctrl+S on Windows sau ⌘S pe Mac. {% endhint %}
Orice draft poate fi accesat în meniul din sidebar de edit. De aici îți poți selecta draft-ul și poți continua lucrul. Poți vedea și dacă ceilalți ți-au lăsat comentarii sau feedback!
Atunci când termini de scris un articol, îi poți face "merge" (trad. a îmbina) în conținutul public. Toate modificările pe care le-ai făcut vor fi apoi vizibile, atât de ceilalți membri, cât și de public.
{% hint style="warning" %} Atenție: Folosiți funcția de "merge" numai atunci când știți că modificările sunt finale și gata să fie publice. Dacă nu sunteți siguri că ceva e ok, e destul să salvați modificările fără "merge". De asemenea, puteți face "merge" cu combinația Ctrl+Shift+S în Windows sau ⌘⇧S pe Mac. {% endhint %}
Poți arhiva orice draft care nu va mai ajunge niciodată public apăsând pe butonul "archive". Draft-ul arhivat va ajunge apoi în tab-ul archived
.
Nu te teme, poți scoate din arhivă documente oricând! Intră doar în tab-ul archived
și accesează meniul de opțiuni de la draft-ul respectiv. Poți redeschide un draft oricând dacă ai nevoie de ceva conținut din el.
*va trebui să editezi în markdown, fork la repo-ul de pe git, editezi materialul cu ajutorul StackEdit sau alt editor de markdown, apoi pull-request cu articolul în format .md
{% embed url="https://stackedit.io/app\#" caption="" %}
{% hint style="warning" %}
Scrie pe grupul de Facebook sau lasă un Issue pe GitHub!. {% endhint %}