не могу& #39; не могу найти подробную, конкретную документацию по использованию уценки на проектах github и пользовательских страницах
Я нахожусь в процессе добавления страниц github в некоторые из моих репозиториев и на мою пользовательскую страницу. Для многих веб-страниц я хочу использовать форматирование Markdown.
Однако, поскольку я могу найти только расплывчатую, неподробную информацию о том, как это сделать, я делаю пробную -и -ошибку, чтобы выяснить, как это работает.
Где реальная документация? Кровавые подробности?
Здесь лучшая информация, которую я нашел до сих пор, в которой говорится:
- использовать специальное имя ветки
gh-pagesдля создания сайта для репозитория проекта трехстрочное -заклинание на верхняя часть файла необходима:
--- title: something ---- суффикс меняется на
.html
Но у меня осталось много вопросов о деталях, таких как:
- могу ли я импортировать файлы css?
- Что на самом деле делает эта реклама с названием?
- Какой суффикс должен быть у файлов?
и т. д. Так что мне бы очень хотелось увидеть подробную документацию по всем функциям.
Обратите внимание, что этот вопрос не о том, как использовать синтаксис Markdown, а о том, как использовать магию github для автоматического создания html из Markdown в рамках страниц пользователя и проекта.