Reference-uk це репозіторій який містить Довідник мови Arduino з документацію синтаксису українською мовою. Усі файли довідників в форматі AsciiDoc.
Дякуємо, що знайшли час щоб зробити свій внесок у Arduino, це дійсно корисно для всієї спільноти Arduino. Якщо ви хочете дізнатись більше про те, як зробити внесок у цей проект, перегляньте цей покроковий посібник.
Якщо ви хочете додати новий вміст, створіть новий файл (в будь-якому редакторі тексту або коду) і збережіть його як .adoc.
Не використовуйте дужки або будь-які спеціальні символи в назві файлу.
Ознайомтесь з описом синтаксису AsciiDoc reference-en/AsciiDoc_sample/AsciiDoc_Dictionary. Він містить опис заголовків, тексту, посилань, зображень, таблиць, коду та різних вставок (відео, слайд-шоу, аудіо та код). Ви можете переглянути опис синтаксису тут.
Якщо ви хочете внести свій внесок у Довідник мови або відредагувати наявний вміст, ви можете знайти два шаблони в reference-en/AsciiDoc_sample/Reference_Terms:
-
Використовуй
AsciiDoc_Template-Single_Entity.adoc(на сайті тут) для таких термінів, як analogWrite. -
Використовуй
AsciiDoc_Template-Parent_Of_Entities.adoc(на сайті тут) для груп функцій, наприклад як Serial.
Зверни увагу, що кожен довідковий файл повинен містити опис, приклади коду та посилання на іншу відповідну інформацію (див. розділ Також).
Якщо потрібно додати зображення до Asciidoc, створіть каталог з назвою attachments у тому ж каталозі, що і файл Asciidoc. Зображення можна зберігати у форматі SVG та PNG, з розміром до 200 Кб.
Якщо не знайомі з Git, то можна додавати вміст безпосередньо на Github через онлайн-інтерфейс. Ми підготували короткий посібник, щоб показати, як це зробити!
Ви також можете слідувати цьому посібнику (написаному командою Github), щоб дізнатися, як редагувати файл .adoc та запропонувати зміни команді Arduino. Пропонуючи зміни, будь ласка, дотримуйтесь інструкцій, описаних у файлах з шаблонами довідників.
Ми раді, що ви хочете зробити свій внесок у довідник Arduino: це найкращий спосіб допомогти спільноті.
Ваш внесок — це додавання або модифікація існуючого коду або повних описів, будь ласка, завжди посилайтеся на існуючий issue або відкрийте новий перед тим, як запропонувати зміни.
reference-uk
├─ AsciiDoc_sample
│ ├── AsciiDoc_Dictionary
│ │ ├── AsciiDoc_Template-Dictionary.adoc
│ │ └── attachments
│ └── Reference_Terms
│ ├── AsciiDoc_Template-Parent_Of_Entities.adoc
│ ├── AsciiDoc_Template-Single_Entity.adoc
│ └── attachments
├── Language
│ ├── Functions
│ ├── Structure
│ └── Variables
├── LICENCE.md
└── README.adocУ каталозі Language дерево файлів має ту саму структуру, що і на веб-сторінці довідника Arduino.
Зверніть увагу, що ваш внесок у Arduino довідник ліцензований за ліцензією Creative Commons Attribution-Share Alike 3.0. дивись https://creativecommons.org/licenses/by-sa/3.0/
