JupyterBook: начало

.gitignore

@@ -0,0 +1,5 @@
+# JupyterBook
+jupyter_book/_build/
+
+# Mac shit
+.DS_Store

.pre-commit-config.yaml

@@ -0,0 +1,22 @@
+repos:
+  - repo: https://github.com/pre-commit/pre-commit-hooks
+    rev: v4.0.1
+    hooks:
+      - id: check-added-large-files
+      - id: check-docstring-first
+      - id: check-json
+      - id: check-xml
+      - id: end-of-file-fixer
+      - id: trailing-whitespace
+        args: ["--markdown-linebreak-ext=md"]
+
+# Too much noise from Yaspeller (have to extend the dictionary too often),
+# better to run manually from time to time
+# `yaspeller -l en jupyter_book/book/`
+#
+#  - repo: https://github.com/hcodes/yaspeller.git
+#    rev: v8.0.0
+#    hooks:
+#      - id: yaspeller
+#        types: [markdown]
+#        files: \.md$

README.md

@@ -1 +1,22 @@
-# open-ml-course
+# Открытый курс машинного обучения
+
+
+[Открытый курс](https://ods.ai/tracks/open-ml-course) машинного обучения возрождается, как феникс! Соревнования, дедлайны, общий рейтинг, куча теории и практики, юморок – все на русском и бесплатно, как в далеком 2017 году. Ранее курс вел Юрий Кашницкий (@yorko), теперь – Пётр Ермаков (@ermakovpetr). Курс на английском [mlcourse.ai](https://mlcourse.ai) остается жить в self-paced формате, а этот курс будет активно перезапускаться.
+
+Возрожденный открытый курс машинного обучения от OpenDataScience "ML-курс ODS" стартует 1 февраля 2022 г. Можно записаться на трек, чтоб следить за новостями. [В правом верхнем углу](https://ods.ai/tracks/open-ml-course) ткните "Start the track" и войдите с аккаунтом ods.ai, если есть, или заведите таковой (пожалуйста, указывайте реальное имя, оно пойдет рейтинг курса, как, например, [тут](https://ods.ai/tracks/nlp-course/leaderboard) в курсе NLP). 
+
+Тут происходит развилка:
+
+- Англоязычная версия курса mlcourse.ai остается в режиме sеlf-paced, ее по-прежнему поддерживает Юрий Кашницкий (@yorko)
+- Русскоязычную версию курса (которую вы сейчас видите) в ближайшие 3 года будет тащить Петр Ермаков (@ermakovpetr) – сооснователь сообщества ODS, Senior Data Scientist в Lamoda, руководитель школы datagym.ru
+
+Курс на русском возродится в том же формате, в каком он запускался в 2017 году -- c дедлайнами, соревнованиями, проектами, общим рейтингом, кучей теории и практики, шутейками и стикерами.
+
+## Jupyter-book
+
+Инструкции по сборке:
+
+ - выполните в корне `jupyter-book build jupyter_book/`
+ - откройте файл `jupyter_book/_build/index.html` в браузере
+
+ В остальном см. примеры: [JupyterBook intro](https://jupyterbook.org/intro.html) + mlcourse.ai [в виде JupyterBook](https://yorko.github.io/mlcourse.ai/book/index.html), [source](https://github.com/Yorko/mlcourse.ai/tree/main/mlcourse_ai_jupyter_book)

jupyter_book/_config.yml

@@ -0,0 +1,46 @@
+title : Открытый ML курс
+author: Петр Ермаков (ermakovpetr)
+logo: _static/img/mlcourse_ai_logo.jpg
+
+# Short description about the book
+description: >-
+  Открытый курс ods.ai по машинному обучению
+
+repository:
+  url                       : https://github.com/ermakovpetr/open-ml-course
+  path_to_book              : jupyter_book
+  branch: main  # Which branch of the repository should be used when creating links (optional)
+
+execute:
+  execute_notebooks           : cache
+  timeout: -1
+
+# exclude some content
+exclude_patterns: []
+
+# HTML-specific settings
+html:
+  favicon                     : _static/img/favicon.ico
+  home_page_in_navbar         : true  # Whether to include your home page in the left Navigation Bar
+  use_edit_page_button        : true  # Whether to add an "edit this page" button to pages. If `true`, repository information in repository: must be filled in
+  use_repository_button       : true  # Whether to add a link to your repository button
+  use_issues_button           : true  # Whether to add an "open an issue" button
+
+# Interact link settings
+notebook_interface            : "notebook"
+
+# LaTeX settings
+# bibtex_bibfiles:
+#    - _bibliography/references.bib
+latex:
+  latex_engine                : "xelatex"
+  latex_documents:
+    targetname: book.tex
+
+sphinx:
+  config:
+    # html_extra_path: ['_static/data']
+    # html_extra_path: ['_static/img']
+    html_js_files:
+      - https://cdnjs.cloudflare.com/ajax/libs/require.js/2.3.4/require.min.js
+      - https://c6.patreon.com/becomePatronButton.bundle.js