Github-страницы не отображаются, вместо этого получается строка - PullRequest
0 голосов
/ 20 июня 2019

Для моего сайта на страницах github я пытался использовать таблицы уценки, но они не работают:

| hello | hi |
| --- | --- |
| hi | hello |

Я получаю строку следующим образом:

| hello | hi | | --- | --- | | hi | hello |

Вы можете видеть это из этой страницы

1 Ответ

0 голосов
/ 21 июня 2019

Ваша таблица должна быть окружена пустыми строками:

Usage: <code>$PatoBot->removeAdmin($id);</code>

| Argument | Description |
| --- | --- |
| $id | The user id to be removed from the admin list |

Returns true if the user was in the admin array and was removed, false if not.

Обратите внимание, что я удалил теги <br> и добавил пустую строку до и после таблицы.

Причина, по которой это требуется для страниц GitHub, но не для самого GitHub, заключается в том, что используется другой процессор Markdown. Хотя эти две реализации очень похожи, между ними есть несколько отличий. Это одна из них.

Jekyll (генератор статических сайтов, используемый GitHub Pages) действительно включает поддержку Commonmark , однако, согласно readme в репозитории , вариант GitHub Markdown находится только в тестировании в это время. Документы также предполагают, что расширения (включая таблицы) не включены по умолчанию, поэтому, если вы используете его, вам также нужно явно включить нужные расширения. Согласно самой последней информации , предоставленной GitHub, GitHub Pages использует стандартное значение Jekyll Kramdown , которое поддерживает таблицы по умолчанию, но более строгое требование, чтобы таблицы были окружены пустыми строками, чем Общий знак с расширением таблицы. В этом отношении, я не уверен, что Commonmark даже доступен в Pages. Jekyll добавил поддержку в версии 3.1, и Pages в настоящее время поддерживает версию 3.3, но нигде GitHub не заявил, что они поддерживают Commonmark на страницах GitHub с момента их объявления в феврале 2016 года, что они поддерживают только Kramdown (по крайней мере, я не смог найти это где угодно).

Учитывая вышеизложенное, Markdown, используемый для страниц GitHub, должен соответствовать правилам Kramdown .

...