Skip to content

Leon010203/mt-wiki

This branch is 1 commit behind saahov/mt-wiki:master.

Folders and files

NameName
Last commit message
Last commit date

Latest commit

c618cf1 · Jul 24, 2011

History

32 Commits
Jun 18, 2011
Jun 16, 2011
Jun 17, 2011
Jun 17, 2011
Jun 17, 2011
Jun 16, 2011
Jun 17, 2011
Jun 16, 2011
Jun 17, 2011
Jun 16, 2011
Jun 17, 2011
May 28, 2011
May 28, 2011
Jul 24, 2011
May 28, 2011

Repository files navigation

Публичный репозиторий для документации.

Как работать с документацией

Для работы с документацией достаточно сделать следующее:

1. Сделать форк репозитория с документацией

Для этого зайдите на страницу github.com/saahov/mt-wiki и нажмите на кнопку «Fork», как показано на этой картинке:

Fork

После этого в вашем аккаунте появится репозиторий, который будет привязан к этому.

2. Склонировать свой репозиторий на компьютер

Для дальнейшей работы необходимо склонировать репозиторий, чтобы можно было с помощью обычного текстового редактора редактировать файлы. Чтобы склонировать репозиторий с помощью терминала, выполните команду:

git clone git@github.com:ваше_имя_пользователя/mt-wiki.git

В результате выполнения данной команды на вашем компьютере будет создан локальный репозиторий, в котором вы сможете редактировать и создавать файлы документации.

3. Отредактировать какие-либо файлы или добавить свои

После клонирования репозитория, вы можете добавлять, изменять файлы документации.

Обратите внимание: Файлы документации должны быть с расширением .md. Это значит, что форматирование текста происходит в формате Markdown. Основные элементы форматирования с примерами есть в этом документе.

4. Отправка изменений в свой репозиторий

После того, как вы изменили документы, выполните следующие команды в терминале:

1). Добавление новых файлов:

git add .

2). Фиксация изменений:

git commit -a -m "Краткое описание изменений"

3). Отправка изменений в свой удалённый форк (в ветку master):

git push origin master

5. Интеграция изменений с основной документацией

Теперь, когда ваши изменения видны на Github, необходимо интегрировать их с основной документацией. Для это откройте страницу со своим репозиторием и нажмите на кнопку «Pull Request».

Pull

Откроется диалог запроса на интеграцию изменений. Здесь также необходимо указать краткое описание изменений. После отправки запроса в самое ближайшее время ваши изменения будут интегрированы.

Структура каталогов в документации

  • assets — статические файлы (картинки, скриншоты)
  • common — страницы об основных темах
  • examples — примеры шаблонов, различные хаки
  • hosting — статьи о хостинге для Movable Type
  • imports — статьи об импорте с других платформ
  • install — статьи об установке
  • mtpro — статьи о MT Pro
  • other — статьи мало относящиеся к MT
  • plugins — статьи о плагинах
  • tips — различные советы
  • update — статьи об обновлении

Рекомендации по стилю

Никаких особых требования к стилю нет. Но будет хорошо, если автор статей будет:

  • обращаться к читателю обезличенно;
  • в обращениях использовать «вы» вместо «ты».

Форматирование документов

Для форматирования текста используется синтаксис Markdown. Это достаточно простой синтаксис, который поддерживается большинством текстовых редакторов. Пример:

Редактирование документа

Рекомендуется использовать следующие параметры редактора:

  • Пробелы вместо табуляции;
  • Ширина табуляции — 4 пробела;
  • Кодировка — UTF-8.
  • Расширение документа — .md.

Примеры форматирования

# Заголовок документа (обязателен, иначе будет отображаться имя файла)

Текст документа.

## Заголовок второго уровня

### Заголовок третьего уровня

#### Заголовок четвёртого уровня

* Первый элемент списка
* Второй элемент списка
* Третий элемент списка

1. Первый элемент нумерованного списка
2. Второй элемент нумерованного списка
3. Третий элемент нумерованного списка

> Текст цитаты

[текст для внешней ссылки](http://example.com/)

[[текст для внутренней ссылки|имя документа, на который будет ссылка]] — имя документа должно быть расширения.

**Текст, выделенный жирным**

_Текст, выделенный курсивом_

Подсветка кода на страницах

Примеры выделения кода:

1). Выделенный код в той же строке (например, так рекомендуется выделять все теги MT, пути, адрес URL в примерах):

`<mt:Example/>`
  1. Блок кода с обеих сторон заключается тремя символами:

3) Для блока кода можно указывать определённый синтаксис:

Возможные примеры синтаксиса: xml (рекомендуется для тегов MT), html, perl, php, bash, apache, mysql, sql, js, css.

About

Movable Type Wiki

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published