docs/intro.rst

@@ -0,0 +1,80 @@
+Stručné přiblížení nástrojů pro vývoj webu
+@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@
+
+K vývoji webu se používá nemalé množství nástrojů, které mohou být potenciálně
+nové. Tahle stránka se snaží je přiblížit a ukázat aspoň základní použití.
+
+.. note::
+
+   Tenhle soupis cílí na lidi, co mají „spíš míň“ zkušeností s vývojem SW
+   v Pythonu a/nebo na/pro Linuxový server a/nebo v týmu a/nebo atd. Pokud
+   zkušenosti máš, je pravděpodobné, že se z některých/všech částí soupisu
+   nedozvíš nic nového – pokud si věříš, klidně tento návod přeskoč a kdyžtak
+   se vrať ☺
+
+.. warning::
+
+   Tenhle návod byl původně sepsán technicky zdatným webařem (LEdem). Je proto
+   možné, že i když se snaží vysvětlovat věci hodně základně, tak to pořád je
+   moc cizích slov ☹ Neboj se návod upravit, doptávat se na věci nebo poslat
+   zpětnou vazbu, díky!
+
+.. note::
+
+   Je možné, že se tyhle informace protínají s potřebami ostatních orgů –
+   newebařů (typicky TeXaři). Klidně vhodnou část zkopírujte na wiki, nedělám
+   si nárok na to mít to jen tady ☺ Ale přirozeně je text cílený na webaře a
+   nezaručuji přímou použitelnost na jiné orgy ☺ (Asi považuji za dobré, aby
+   nějaká forma tohoto textu byla ve webařské dokumentaci, podle :ref:`dřívějšího
+   úzu <Postup zkrášlení kódu M&Mího webu>` je wiki moc daleko a máme
+   tendenci na ni ještě víc zapomínat…
+
+Linuxový terminál
+=================
+
+WSL2, aneb Linuxový terminál pod Windows
+----------------------------------------
+
+.. error:: Nic nevím, někdo to napište. (Umím potenciálně zjistit, ale bude to za dlouho…)
+
+Instalace balíčků
+-----------------
+
+Venv / virtualenv / virtuální prostředí pro Python
+==================================================
+
+Git
+===
+
+Gitea
+=====
+
+Jak na pull requesty
+--------------------
+
+Kanboard
+========
+
+SSH
+===
+
+Tip: SSH klíče
+--------------
+
+Python
+======
+
+.. note:: Je sem vůbec co psát?
+
+Pythoní IDE
+-----------
+
+.. error:: Nic nevím, nemám žádnou zkušenost, píšu ve Vimu a jsem spoko. Někdo to prosím doplňte ☺
+
+Django
+======
+
+.. note:: TODO: sepsat stručně přednášku o Djangu na separátní stránce, tady se to jinak utopí…
+
+Kanboard / Kanec
+================