Enable markdown

content/about.md

@@ -0,0 +1,26 @@
+# Про ada-ukraine.github.io
+
+ada-ukraine.github.io - це інтерактивна навчальна платформа, призначена
+для вивчення мов програмування Ада та SPARK. Завдяки курсам з практичними
+завданнями та зрозумілими фрагментами коду ви матимете можливість побачити,
+зрозуміти та поекспериментувати з можливостями мови.
+
+## Про Ада/SPARK
+
+Мова програмування Ада з самого початку була розроблена для використання
+в системах, де безпека та надійність мають першочергове значення. Її набір
+функцій і парадигми програмування, за задумом, дозволяють розробникам
+програмного забезпечення розробляти програми більш ефективно і результативно.
+Вона заохочує принцип «спочатку думай, а потім кодуй», що сприяє створенню
+більш читабельного, надійного та зручного в обслуговуванні програмного
+забезпечення.
+
+Мова програмування SPARK є формально верифікованою підмножиною мови Ада,
+яка дозволяє розробникам математично доводити коректність програми
+за допомогою статичних засобів. Це досягається завдяки використанню
+сильних сторін синтаксису мови Ада, усуваючи при цьому особливості мови,
+які призводять до неоднозначності та недетермінованої поведінки.
+
+Мова разом з інструментарієм верифікації та методологією проектування
+забезпечує розробку та розгортання програмного забезпечення з низьким
+рівнем дефектів для додатків з високим рівнем надійності.

content/index.md

@@ -0,0 +1,32 @@
+# Ada-Ukraine.github.io
+
+## Що ж таке Ада? 
+
+Ада - це сучасна мова програмування, яку команди розробників по всьому
+світу використовують для створення критично важливого програмного
+забезпечення: від мікроядер і мініатюрних вбудованих систем реального
+часу до масштабних корпоративних рішень і всього, що знаходиться між цим.
+
+```{toctree}
+:maxdepth: 2
+:caption: "Contents:"
+
+about
+```
+
+## Спробуй Аду прямо зараз:
+
+```{code} ada run_button project=Introduction main=learn.adb
+
+with Ada.Text_IO; use Ada.Text_IO;
+
+procedure Learn is
+
+   subtype Alphabet is Character range 'A' .. 'Z';
+
+begin
+
+   Put_Line ("Learning Ada from " & Alphabet'First & " to " & Alphabet'Last);
+
+end Learn;
+```

frontend/requirements.txt

@@ -1,3 +1,4 @@
+myst_parser==4.0.0
 coverage==7.6.0
 docutils==0.20.1
 graphviz==0.20.3

frontend/sphinx/conf_patch_ukr.py

@@ -1,5 +1,17 @@
 # Injection into conf.py for Ukrainian
 
-# exclude_patterns += ['courses', "labs", "training_examples"]
+exclude_patterns += [
+    'about.rst',
+    'index.rst',
+    '**/README.md'
+]
+
+extensions += [
+    "myst_parser",
+]
+
+html_logo = "img/logo_ukr.svg"
 
 language = 'uk'
+
+# master_doc = 'index_ukr'