Differences

This shows you the differences between two versions of the page.

--- en:tools [2019/02/15 15:55] – fluktuacia
+++ en:tools [2019/02/18 14:20] – fluktuacia
@@ Line 379: / Line 379: @@
 The programme can be opened in the usual from dashboard or using command line.
-Pro použití nejnovějších funkcí je vhodné použít denní kompilaci openscadu.
+For the newest functions to be available use the daily Openscad compilation:
   sudo apt-get install openscad-nightly
-Tu lze pak spustit z příkazového řádku jako openscad-nightly, obě verze proto mohou být naistalované paralelně.
+It can be run from the command line like openscad-nightly, both versions can be installed in parallel.
 <WRAP center round tip 80%>
-Pro zobrazení náhledů vygenerovaných STL souborů v prohlížeči Nautilus můžete využít nástroj [[https://github.com/MLAB-project/stl-thumbnailer|stl-thumbnailer]].
+To display the STL generated views in Nautilus, you can use [[https://github.com/MLAB-project/stl-thumbnailer|stl-thumbnailer]] tool.
 </WRAP>
-=== Styl psaní kódu (coding style) ===
+=== Coding style ===
-Je praktické dodržovat některá základní pravidla při vytváření modelů v openscadu.
+It is practical to follow some basic coding style rules when creating models in opens cad.
-  * Názvy proměnných vytvářet v mezinárodním jazyce (angličtina a globálně známé výrazy a zkratky)
+  * Use international language for the names of variables (English, using globally known expressions and abbreviations)
-  * Příliš nezkracovat názvy proměnných
+  * Do not shorten the names of variables too much
-  * Proměnné a operátory oddělovat mezerami
+  * Separate the variables and operators by spaces
-  * Používat odsazení o 4 mezery (tabulátor) ve vnořeném bloku kódu
+  * Use 4 space indentation (tabulator) in a nested code block
-=== Použití editoru SublimeText ===
+=== Using SublimeText editor ===
-Editor integrovaný přímo do OpenSCADu není moc pohodlný pro užívání. Je proto vhodnější zdrojové kódy modelů editovat v editoru [[https://www.sublimetext.com/|SublimeText 3]].  K tomu je ale vhodné si do editoru nainstalovat plugin, který zná jazyk OpenSCADdu.
+The editor integrated directly into OpenSCAD is not very comfortable for use. Therefore we prefer to edit the source codes of models in [[https://www.sublimetext.com/|SublimeText 3]] editor - you can install a plugin that recognises the OpenSCAD language.
-Instalaci lze provést přes systém balíčků, který můžeme aktivovat volbou //Tools -> Install Package Control..//.
+The installation can be done through a system of packages that can be activated via  //Tools -> Install Package Control..//.
 {{:cs:sw:sublimetext3_package_control_install.png?400|}}
-Otevřeme nástroj pro zacházení s balíčky volbou //Preferences -> Package Control//.
+Open the package control tool with  //Preferences -> Package Control// option.
 {{:cs:sw:sublimetext3_package_control.png?400|}}
-V nabídce zvolíme "Install Package"
+In the menu choose "Install Package"
 {{:cs:sw:sublimetext3_install_package.png?400|}}
-Do filtračního pole napíšeme "openscad". A klikneme na odpovídající balíček.
+Write “openscad" into a filter field and click the proper package.
 {{:cs:sw:sublimetext3_install_openscad.png?400|}}
-Nyní je potřeba SublimeText zavřít a znovu otevřít, aby se nová konfigurace projevila.
+Now it is necessary to close and re-open the SublimeText so that the new configuration will be set.
-Potom je možné nastavit, aby všechny soubory s příponou //.scad// byly otevřeny s OpenSCAD zvýrazňováním syntaxe. To lze nastavit přes volbu v pravém dolním rohu a výběrem //Open all with current extension as.. -> OpenScad//
+Then it is possible change the setting so that all files with //.scad// suffix will be opened with OpenSCAD syntax highlighting. This setting can be done via an option found in lower right corner and choosing //Open all with current extension as.. -> OpenScad//
 {{:cs:sw:sublimetext3_select_openscad.png?400|}}
-Při následujícím otevření .scad souboru bude automaticky rozpoznán jako OpenSCAD zdrojový kód.
+During the following opening of any .scad file, it will be automatically recognised as a OpenSCAD source file.
-===== Generování a prohlížení výrobních dat =====
+===== Generating and viewing production data=====
-==== Gerber data ====
+==== Data gerber ====
-Pro prohlížení vygenerovaných dat jsou vhodné nástroje:
+To view the generated data, there are several tools available:
   * [[http://gerbv.sourceforge.net/|Gerbv]] - Linux
   * [[http://www.pentalogix.com/|ViewMate]] - Windows
-=== Skládání gerber dat ===
+=== Merging the gerber data ===
-Pro skládáni dat lze využít program gerbmerge. Který se na internetu vyskytuje v několika různých větvích vývoje. Pro použití s programem kicad je vvýhodné použít relativně novou vývojovou větev [[http://www.dent.med.uni-muenchen.de/~kkunzelm/htdocs/6_software-tools-panelize_metric-kicad-files.html| prof.
+In order to merge your data, you can use gerbmerge software - there are several different development branches on the Internet. When you want to use it with kicad software, it is convenient to use a relatively new development branch [[http://www.dent.med.uni-muenchen.de/~kkunzelm/htdocs/6_software-tools-panelize_metric-kicad-files.html| prof.
- Karl-heinz Kunzelmann]].  Ta vychází z prvotní verze 1.8. a dalších úprav. Poměrně významně se však liší od verze [[https://github.com/MLAB-project/gerbmerge3|gerbmerge3]], která ale má čistější zdrojový kód.
+ Karl-heinz Kunzelmann]]. It is base on the first version 1.8 and other adjustements. It differs significantly from a [[https://github.com/MLAB-project/gerbmerge3|gerbmerge3]] version, which on the other hand has a cleaner source code.
-Nejdříve nainstalujeme závislosti.
+First, we install dependencies.
   sudo apt-get install python-simpleparse python-simpleparse-mxtexttools
-Následně stáhneme gerbmerge z githubu.
+Next, we download gerbmerge from GitHub.
   git clone https://github.com/MLAB-project/gerbmerge
   cd gerbmerge
   sudo python setup.py install
-Aby gerbmerge fungoval, tak je mu potřeba zadat způsob panelizace to se dělá konfiguračním souborem. Příklad konfiguračního souboru je vložen u zdrojových kódů programu. Přímo v něm jsou komentáře vysvětlující jeho použití.
+For gerbmerge software to function properly, it has to have a set way of paneling (způsob panelizace). This is done via a configuration file - an example of such file can be found in programme source code (it also contains commentaries explaining its usage). If we have a prepared configuration file, e.g. //layout-mm-3.3.cfg//, we can run the gerbmerge.
-Pakud ale máme připravený konfigurační soubor např. //layout-mm-3.3.cfg// tak gerbmerge můžeme spustit.
   kaklik@popelnice:~/git/gerbmerge/testdata-with-KiCAD-using-metric-units/MLAB_panel$ ../../src/gerbmerge/gerbmerge.py layout-mm-3.3.cfg
-Program se pokusí nalézt optimální rozložení motivů na panelu podle zvolené konfigurace a vygeneruje výsledné složené soubory.
+The programme will try to find an optimal motives’ layout on panel according to a chosen configuration and it will generate merged files.
-Příklad pro složení SET10A (instalace se schoduje s předchozím příkladem)
+An example for merging SET10A (the installation is the same as the previous example).
-Nejprve je potřeba se dostat do místa, kde jsou data setu:
+First, it is necessary to get to the place with the set data:
   MLAB@MLAB:~/MLAB-project/gerbmerge/MLAB_panel/SET10A$
-Nastavení skládání setu je v souboru layout.cfg a v soboru placement.merge.txt je uloženo požadované rozložení v setu. Soubor s rozložením setu se vygeneruje atomaticky při prvním spuštění programu gerbmerge.
+Setting of set merging is found in the layout.cfg file and the placement.merge.txt file contains the requested set layout. A file with set layout will be generated automatically during the first startup of grebmerge programme.
-Vygenerování takto připravených dat se provede následujícím příkazem:
+Generating such prepared data can be done using a following command:
   ../../src/gerbmerge/gerbmerge.py --place-file=placement.merge.txt layout.cfg
 == GerberTools ==
-[[https://github.com/ThisIsNotRocketScience/GerberTools|GerberTools]] je zatím nevyzkoušený open-source nástroj napsaný primárně pro Windows v C#.
+[[https://github.com/ThisIsNotRocketScience/GerberTools|GerberTools]] is so far untried open-source tool written primarily for Windows in C#.
-==== Gkódy pro 3D tisk ====
+==== Gcodes for 3D print ====
-Technologická data pro 3D tisk v MLABu generujeme programem [[http://slic3r.org/|Slic3r]]. Zatím od něj neexistují připravené balíky v použitelné verzi. Proto je nutné program přeložit přímo ze zdrojových souborů na githubu.
+Technological data for 3D printing are in MLAB generating using [[http://slic3r.org/|Slic3r]] software. So far, there are not any ready-made usable packages. Therefore it is necessary to translate the programme directly from the source codes found on GitHub.
-=== Instalace Slic3r ===
+=== Slic3r Installation ===
   sudo apt-get install libextutils-cppguess-perl freeglut3-dev
-=== Postup kompilace ===
-Z githubu se aktuálně používá master větev, která je kompromisem mezi stabilitou a možnostmi software. Samotná kompilace pak probíhá vetšinou podle instrukcí v souboru README.md
+=== Compilation ===
+Currently, a Github’s master branch is used - it is a compromise between stability and the software’s possibilities. The compilation itself is done mostly according to instructions from README.md file.
-===== Programátorské nástroje =====
-Na většinu programování softwaru se používá se v MLABu používá Python, nebo C. Vývojové nástroje jsou pro tyto jazyky dobře obecně známé. Většina vývoje je navíc orientována na Linux.  Proto zde uvedeme jen seznam nástrojů, které používáme.
+===== Programming tools =====
-==== Programovací GUI ====
+Most of the software programming in MLAB uses Python or C. Development tools for these languages are generally well known. Furthermore, most of the development is aimed at Linux. That is why we only provide a list of tools that we use.
-Programovací prostředí v kterém je vytvářen zdrojový kód. Mezi uživateli jsou nejoblíbenější následující dvě volby. Jinak lze ale zdrojový kód psát v libovolném textovém editoru.
+==== Programming GUI ====
+A programming environment where the source code is created. The most favourite among users are the following two option - however, the source code can be written in any text editor.
 === Light Table ===
-[[http://lighttable.com/|Light Table]] je programátorský editor kódu, který vyniká speciálními vlastnostmi, jako je například interaktivní spouštění částí zdrojových kódů, nebo přímé vyhledávání v dokumentaci.
+[[http://lighttable.com/|Light Table]] is a code editor that excels at some special features, such as interactive running of sections of source code or direct search in documentation. Its installation can be done by downloading a compiled package from [[http://lighttable.com/|Light Table Download]], unpacking it and running the following commands that will move it to system folders.
-Jeho instalaci do systému provedeme stažením zkompilovaného balíku z stránky [[http://lighttable.com/|Light Table Download]], rozbalením staženého balíku a provedením následujících příkazů, které jej přesunou do systémových složek.
   sudo mv LightTable /opt/LightTable
@@ Line 496: / Line 496: @@
 === Sublime text ===
-Multiplatformní placený editor pro linux, Windows, Mac OS.  Mezi jeho vyjímečné vlastnosti patří například náhled celého zdrojového kódu. Pro běžné použití stačí nezaplacená varze.
+A Multiplatform paid editor for linux, Window and Mac OS. Some of its special features include an overview of the whole source code. Free version is sufficient for ordinary use.
-== Instalace v Ubuntu ==
+== Ubuntu installation ==
@@ Line 504: / Line 504: @@
   sudo apt-get update
   sudo apt-get install sublime-text-installer
 === Code::Blocks ===
-Jde o velmi rozřířený editor, jehož výhodou je, že běží na více platformách a mohou ho tedy používat i uživatelé windows.
+A widely used editor. It’s advantage is that it runs under various platforms and thus can be used by Windows users as well.
 [[http://www.codeblocks.org/|Code::Blocks]]
@@ Line 513: / Line 514: @@
-==== Embeded systémy ====
+==== Embeded systems ====
-Nástroje na programování jednotlivých typů mikrokontrolérů jsou většinou popsány v částech týkajících se programování u jednotlivých architektur:
+Tools used for programming individual types of microcontrollers are mostly described in sections related to programming under different architectures.
 === PIC ===
@@ Line 523: / Line 524: @@
 === AVR ===
   * [[cs:avr_programming|AVR]]
-===== Správa verzí =====
+===== Version Control =====
@@ Line 531: / Line 532: @@
 ==== GitHub ====
-Pro správu softwarového vývoje a dokumentace modulů používáme [[https://github.com/MLAB-project|github]].
+[[https://github.com/MLAB-project|github]] is used for management of software development and modules’ documentation.
 === Linux ===
-Jako nejefektivnější uživatelské rozhraní pro git se osvědčil příkazový řádek s tím, že jeho efektivita je zde ještě markantnější než u SVN.
+The most effective user interface for git seems to be the command line - here its efficiency is even more striking than in SVN.
+== New user ==
-== Nový uživatel ==
+For a comfortable work with git it is effective to use a method of cloning with SSH - then there is no need for permanent logging in during work. Communication is authenticated base on a privet key. Every computer needs to have a unique one generated.
-Pro pohodlnou ptáci s git je efektivnější používat metodu klonování s SSH. Není při práci vyžadováno stále přihlašování. Komunikace je autentizována na základě privátního klíče. Pro každý počítač je potřeba vygenerovat unikátní klíč.
-  - Je potřeba si založit uživatelský účet na https://github.com/
+  - You need to create a user account on https://github.com/
-  - Následně je potřeba [[https://help.github.com/articles/generating-a-new-ssh-key-and-adding-it-to-the-ssh-agent/|vygenerovat na daném počítači SSH klíč]].
+  - Next, you have to [[https://help.github.com/articles/generating-a-new-ssh-key-and-adding-it-to-the-ssh-agent/|generate an SSH key for the specific computer]].
-  - Vygenerovaný klíč je potřeba [[https://help.github.com/articles/adding-a-new-ssh-key-to-your-github-account/|vložit do účtu na githubu]]
+  - The generated key has to be [[https://help.github.com/articles/adding-a-new-ssh-key-to-your-github-account/|added into your github account]]
-  - Pokud v návodu nefunguje správně uložení klíče do schránky, tak je možné daný klíč získat otevřením skrytého souboru a provést překopírování klíče ručně. ''cat ~/.ssh/id_rsa.pub''
+  - If the addition of the key into clipboard (?? Schránka) does not work properly, it is possible to obtain the key via opening a hidden file and then copying the key manually. ‘’cat ~/.ssh/id_rsa.pub''
-  - Tento postup stačí provést jen při prvním stahování na daném počítači.
+  - This procedure only has to be done during the first download to a given computer.
-== Základní příkazy ==
+== Basic commands ==
-== Klonování repozitáře : ==
+== Cloning a repository : ==
   - Nejprve je potřeba vybrat místo, kde má být repozitář v počítači uložen a v daném místě si otevřít příkazový řádek.