Home
Restitutio manualul-radioamatorului wiki!
Proiectul își propune reconstrucția unui manual tehnic. Din punct de vedere structural un manual tehnic este un ansamblu compus din următoarele elemente:
- Cuprins
- Text formatat în paragrafe cu diferite stiluri
- Ecuații (formule)
- Reprezentări 2D (grafice, diagrame, scheme etc.)
- Reprezentări 3D (ansambluri, subansambluri, repere etc.)
- Imagini foto sau desene cu conținut non-vectorizabil
Pentru input se vor accepta unul sau mai multe documente în format electronic non-vectorizat (scanare primară). În acest fel avem garanția că există niște copii de referință pentru revizuire modificări. E posibil ca un singur document să nu conțină toată informația (cauze: erori scanare, eroare umana, erori generare document post-scanare).
Pentru simplitate, outputul proiectului va fi text în format Markdown (GitHub Flavored Markdown). Pentru mai multe detalii referitoare la sintaxa Markdown vezi Sintaxa-Markdown.
Cuprinsul, într-o abordare top-to-bottom va fi primul element care va fi generat. Într-o formulă general aplicabilă, vom considera conținutul unui document tehnic ca fiind format din următoarele elemente:
- introducere
- parte
- capitol
- subcapitol
- secțiune
Ierarhic, elementele de mai sus, pot fi reprezentate în felul următor:
cuprins
|
+-- introducere
|
+-- partea P{NN} [întâi, a doua, a treia ...]
| |
| +-- capitol C{XX} [Capitolul I, II, III, IV ...]
| |
| +-- subcapitol S{AA} [A, B, C, D ...]
| |
| +-- secțiune T{nn} [1, 2, 3 ...]
|
+--
În cazul în care un element, la același nivel ierarhic, nu are alte elemente de același rang, notația acestuia se va face cu <!-- X. -->, unde X este indexul elementului, conform exemplului de mai jos:
## Capitolul V
### <!-- A. -->Aparate electroacustice
#### 1. Aparate pentru transformarea undelor sonore în curenți de audiofrecvență
#### 2. Aparate pentru convertirea curenților de audiofrecvență în unde sonore
## Capitolul VIPentru ecuații, formule, expresii matematice în general, vom utiliza limbajul LaTeX. Nu în mod direct, deoarece GitHub nu are (încă) suport direct pentru sintaxa LaTeX. Ecuațiile și formulele vor fi în format svg. Generarea acestora se va realiza cu ajutorul https://www.codecogs.com/latex/eqneditor.php. Se salveaza în format svg și se plasează în folderul equations
Pentru mai multe detalii referitoare la sintaxa LaTeX vezi 1.b Ce este LaTeX.
[MILIAMPERUL(mA)=\frac{1}{1000}A](https://github.com/matei-tm/manualul-radioamatorului/blob/master/output/equations/partea_01/capitolul_01/equ_6c0c896837fa4f2bb4e69acc0e427c22.svg)
<p align="center">
<img src="https://github.com/matei-tm/manualul-radioamatorului/blob/master/output/equations/partea_01/capitolul_01/equ_73b3f2215a134231a8a83c96422861a5.svg" alt="x=\frac{-b\pm\sqrt{b^2-4ac}}{2a}" />
</p>
Schemele sau diagramele vor fi în final în format vectorial svg. În funcție de tipul elementelor grafice se pot folosi:
- FreeCAD - desen tehnic https://www.freecadweb.org/
- Inkskape - desen artistic https://inkscape.org/.
<p align="center">
<img src="https://github.com/matei-tm/manualul-radioamatorului/blob/master/output/drawings/partea_01/capitolul_01/fig_0001.svg" alt="capitol 1 figura 1" />
</p>
<p align="center">
<i>Fig. 1</i>
</p>
Fig. 1
Imaginile cu echipamente 3D pot fi desenate într-o aplicație CAD open source (Ex. FreeCAD). Se va exporta o proiecție izometrică în format svg. Sursele 3D, în cazul în care au dimensiuni peste 10MB, pot fi publicate pe https://grabcad.com.
Toate imaginile non-vectorizabile vor fi în format png. Acestea vor fi referite logic cu tag img, iar plasarea fizică va fi în folderul output/images
<p align="center">
<img src="https://github.com/matei-tm/manualul-radioamatorului/blob/master/output/images/partea_01/capitolul_01/fig_0004.png" alt="capitol 1 figura 1" />
</p>
<p align="center">
<i>Fig. 4</i>
</p>
Fig. 4
Dacă vrei să ne ajuți, vezi mai departe