3. Cum fac
Dacă nu ai citit despre organizarea proiectului, vezi 1.d-Organizarea-proiectului. După ce te-ai lămurit cu organizarea proiectului poți să te întorci aici
Editorii vor genera conținut doar în directorul src.
Pentru informații detaliate referitoare la instalarea uneltelor de editare vezi 1.c-Ce-unelte-folosesc
Recomandăm Visual Studio Code cu plugin-uri:
- Markdown All in One
- GitLens
- Insert GUID
Pentru uniformitate recomandăm editorul https://www.codecogs.com/latex/eqneditor.php.
Inkskape https://inkscape.org/. Este un editor svg open source.
Textul se modifică în [output/DOCUMENT-PARTEA_xx-CAPITOLUL_yy.md] unde:
- xx - partea X
- yy - capitol YY
Puteți utiliza un serviciu de recunoaștere optică a textului. Sunt nenumărate variante free online. Un exemplu poate fi https://newocr.com. Dacă doriți să folosiți acest serviciu, am creat un scurt tutorial (68s) fără pretenții ultra academice:
Pentru inserții de text care reprezintă cazuri izolate cu exponenți, puteri, indici superiori sau alte situații asemănătoare, în care nu este necesară o ecuație distinctă, se va folosi marcatorul <sup>.
Exemplu:
Energia sistemului este E = mc2
Energia sistemului este E = mc<sup>2</sup>
Pentru inserții de text care reprezintă cazuri izolate cu indici inferiori sau alte situații asemănătoare, în care nu este necesară o ecuație distinctă, se va folosi marcatorul <sub>.
Exemplu:
Dioxidul de carbon se notează CO2
Dioxidul de carbon se notează CO<sub>2</sub>
Expresiile matematice complexe (formule, ecuații) vor fi definite în format svg. Fișierele svg se vor plasa in directorul equations, referit relativ față de locația documentului. Pentru generarea acestora se va folosi serviciul online https://www.codecogs.com/latex/eqneditor.php. Un scurt tutorial (58s) este prezentat mai jos:
La inserarea ecuațiilor formatul Markdown este următorul:
Ecuațiile vor conține în eticheta Markdown (între parantezele pătrate []), sintaxa LaTeX.
Schemele sau diagramele vor fi, în final, în format vectorial svg.
Fișierul cu elementele grafice se salvează în directorul de lucru /src/contribution/drawings/partea_xx/capitolul_yy, conform cerințelor din 1.d-Organizarea-proiectului.
În funcție de tipul elementelor grafice, se pot folosi:
- Inkskape - desenare generală https://inkscape.org/.
- Fritzing - prototipuri electronice http://fritzing.org/home/
- LibreCAD - desen tehnic 2D https://librecad.org/
În document fișierele vor fi referite relativ, conform exemplelor următoare.
<p align="center">
<img src="drawings/partea_01/capitolul_01/fig_0001.svg" alt="capitol 1 figura 1" />
</p>
<p align="center">
<i>Fig. 1</i>
</p>
Fig. 1
[todo] https://github.com/fsmMLK/inkscapeMadeEasy, https://github.com/fsmMLK/inkscapeCircuitSymbols
Reprezentările 3D se realizează cu ajutorul FreeCad. Proiectele se plasează în directorul src/contribution/freecad.
Sursele 3D, în cazul în care au dimensiuni peste 10MB, pot fi publicate pe https://grabcad.com.
Se va exporta o proiecție izometrică (care va respecta regulile de formatare ale reprezentărilor 2D) în format svg. Fișierul cu proiecția izometrică se salvează în directorul de lucru /src/contribution/drawings/partea_xx/capitolul_yy, conform cerințelor din 1.d-Organizarea-proiectului.
<p align="center">
<img src="drawings/partea_01/capitolul_01/fig_0004.svg" alt="capitol 1 figura 4" />
</p>
<p align="center">
<i>Fig. 4</i>
</p>
Fig. 4
Fișierul cu proiecția izometrică se salvează în directorul de lucru
Toate imaginile non-vectorizabile vor fi în format png. Acestea vor fi referite logic cu tag img, iar plasarea fizică va fi în folderul /src/contribution/images/partea_xx/capitolul_yy (referit relativ față de locația documentului), conform cerințelor din 1.d-Organizarea-proiectului.
<p align="center">
<img src="images/partea_01/capitolul_01/fig_0004.png" alt="capitol 1 figura 1" />
</p>
<p align="center">
<i>Fig. 4</i>
</p>
Fig. 4
Conținutul subcapitolelor se poate dezvolta simultan.
Pentru început vom prelua imaginile în format bitmap din scanări. În final imaginile bitmap vor fi refăcute în format vectorial svg.