Страницы страниц GitHub неправильно строятся? - PullRequest
Новая
       11

Страницы страниц GitHub неправильно строятся?

0 голосов
/ 25 ноября 2018

Страница страниц GitHub моего репозитория построена из README, и все работало нормально, но, поскольку я добавил некоторые изображения в README.md, страница стала беспорядочной.Может быть, это из-за того, как я добавляю изображения?Или это Джекилл-баг?Это начало файла README.md: 

# Salty Engine
![version-badge](https://img.shields.io/badge/version-0.14.0-orange.svg) ![release-badge](https://img.shields.io/badge/release-0.12.5-brightgreen.svg) ![price-badge](https://img.shields.io/badge/price-free-red.svg) ![license-badge](https://img.shields.io/badge/license-MIT-blue.svg)
<p>

![salty-engine-logo](logos/logo_small.png)

Salty Engine is a Java library for making a whole 2D Game with only one single library/engine. It aims to be the most user-friendly and easy-to-use 2D Game making tool for Java.

This is how the page looks This is how the readme looks

И, наконец, репо можетнайти здесь -> https://github.com/edgelord314/salty-engine и страницу здесь -> https://edgelord314.github.io/salty-engine/

Ответы [ 2 ]

0 голосов
/ 26 ноября 2018

Github использует GitHub Flavored Markdown (GFM) для рендеринга файлов уценки в вашем хранилище и отображения их в их веб-интерфейсе на github.com.

На другой стороне Github Pages / Jekyllиспользует Kramdown.

Чтобы дать Jekyll команду анализировать файлы уценки, вы должны добавить начальную информацию. 

---
# this is an empty front matter
---
<p>Yolo</p>

Во-вторых, вам нужно настроить kramdown для анализа внутри элементов блока.

В вашем _config.yml : 

theme: jekyll-theme-hacker
kramdown:
  parse_block_html: true
0 голосов
/ 26 ноября 2018

Удалите тег <p> после значков. 

# Salty Engine
![version-badge](https://img.shields.io/badge/version-0.14.0-orange.svg) ![release-badge](https://img.shields.io/badge/release-0.12.5-brightgreen.svg) ![price-badge](https://img.shields.io/badge/price-free-red.svg) ![license-badge](https://img.shields.io/badge/license-MIT-blue.svg)
<p>  <=REMOVE THIS

На github.com Commonmark используется для анализа Markdown, в то время как Jekyll использует традиционный анализатор Markdown.Как указано в спецификации , CommonMark обрабатывает необработанный HTML иначе, чем исходные правила Markdown, и это объясняет разницу в выводе.

In традиционная Markdown, все содержимоеэлемент уровня блока не анализируется как текст уценки.А поскольку HTML не требует закрывающего тега <p>, синтаксический анализатор Markdown принимает все после того, как открывающий тег находится внутри этого абзаца.Фактически, если вы посмотрите на визуализированный HTML-код (используйте браузер 'view source' или 'inspect' tool), вы увидите, что на самом деле есть закрывающий тег </p> в конце документа.Другими словами, весь остальной документ рассматривается как находящийся внутри необработанного HTML-тега на уровне одного блока и, следовательно, не анализируется как Markdown (согласно правилам).

Однако CommonMark нарушает эти правиласледуя только за ними, если в исходном HTML нет пустых строк.Однако, поскольку первая строка после открывающего тега <p> является пустой строкой, Commonmark немедленно закрывает тег <p> и затем анализирует остальную часть документа как обычный текст Markdown.Поэтому страница отображается по-другому на github.com.

...