Підготуйтеся до запуску

Перш ніж ми будемо готові запустити свій трек, переконаймося, що виконано такі завдання.

Замовлення піктограми треку

Щоб розробити піктограму для сайту, відкрити новий issue в репозиторії exercism/website-icons, відповівши на такі запитання:

  • Чи має мова офіційний логотип? Якщо так
    • додаймо посилання на приклад
    • перелічімо вимоги щодо зазначення авторства та права, надані для використання цього логотипа
  • Чи має мова неофіційний логотип? Якщо так
    • пояснімо, як люди використовують неофіційний логотип
    • додаймо посилання на приклад
    • перелічімо вимоги щодо зазначення авторства цього логотипа

Додавання документів треку

Додаймо такі документи треку:

  • docs/ABOUT.md: короткий вступ до мови.
  • docs/INSTALLATION.md: опишімо, що учневі потрібно встановити, щоб працювати над треком у власній локальній системі за допомогою CLI.
  • docs/LEARNING.md: посилання на навчальні ресурси.
  • docs/RESOURCES.md: посилання на корисні ресурси.
  • docs/TESTS.md: опишімо все, що стосується запуску тестів у треку.

Ці документи допоможуть учневі почати роботу з треком, а також дізнатися більше про трек і його мову. Докладніше: документація про документи.

Додавання документів вправ

Додаймо такі документи вправ:

  • exercises/shared/.docs/help.md: містить вказівки, специфічні для треку, про те, як отримати допомогу
  • exercises/shared/.docs/tests.md: містить вказівки, специфічні для треку, про те, як запускати тести

Додавання фрагмента коду

Додаймо фрагмент коду до файлу docs/SNIPPET.txt. Цей фрагмент наочно показує, який має вигляд синтаксис мови. Докладніше: документація про документи.

Оновлення метаданих

Метадані треку визначено у файлі config.json. Потрібно оновити такі властивості:

  • language: мова треку (наприклад, "C#"). Її довжина має бути <= 255
  • slug: мова треку у вигляді рядка тексту (англ. string) у нижньому регістрі з дефісами замість пробілів (kebab-case) (наприклад, "csharp"). Його довжина має бути <= 255
  • blurb: короткий опис мови. Його довжина має бути <= 400
  • online_editor: обʼєкт, що описує налаштування, які використовує онлайн-редактор:
    • indent_style: або "space", або "tab"
    • indent_size: розмір відступу як ціле число (наприклад, 4)
    • highlightjs_language: ідентифікатор мови для Highlight.js (див. повний список ідентифікаторів). Якщо Highlight.js не підтримує цю мову, це поле можна пропустити.
  • key_features: ключові можливості мови, які стисло описують її найважливіші можливості. Щоб дізнатися більше, дивімося документацію про ключові можливості.
  • tags: визначмо теги, що застосовуються до цього треку, завдяки чому його можна знайти на сайті. Щоб дізнатися більше та побачити список підтримуваних тегів, дивімося документацію про теги.