Skip to main content
Мы публикуем частые обновления нашей документации, и перевод этой страницы, возможно, еще выполняется. Актуальные сведения см. в документации на английском языке.

Работа с файлами, не связанными с кодом

GitHub Enterprise Server поддерживает отрисовку изображений и поиск различий в нескольких форматах файлов, отличных от кода.

Отрисовка изображений и поиск различий

GitHub Enterprise Server отображает популярные форматы изображений, включая PNG, JPG, GIF, PSD и SVG. Помимо простого отображения, существует несколько способов сравнения различий в версиях этих форматов изображений.

Примечание.

  • GitHub не поддерживает сравнение различий между PSD-файлами.
  • Если вы используете браузер Firefox, SVG на GitHub может не отрисовываться.

Просмотр изображений

Вы можете напрямую просматривать изображения в репозитории в экземпляр GitHub Enterprise Server:

Встроенное изображение

В настоящее время SVG не поддерживают встроенные скрипты и анимацию.

Просмотр различий

Вы можете визуально сравнивать изображения в трех разных режимах: 2-up, swipe и onion skin.

2-up

2-up — это режим по умолчанию, в котором вы смотрите на оба изображения. Кроме того, если в сравниваемых версиях у изображения разные размеры, отображается фактическое изменение размера. Это удобный способ для сравнения объектов разного размера, например при повышении разрешения.

2-up

Swipe

В режиме swipe можно сравнивать части изображения параллельно. Не уверены, изменились ли цвета между версиями? Перетащите ползунок в нужную область и визуально сравните фрагменты.

Swipe

Onion skin

Режим Onion skin пригодится в ситуациях, когда элементы перемещаются на едва заметное расстояние. Например, значок сместился на два пикселя влево. Перетащите ползунок прозрачности немного назад и посмотрите, как сместились элементы.

Onion skin

Средство просмотра трехмерных файлов

GitHub Enterprise Server может размещать и отрисовывать трехмерные файлы с расширением STL.

Если вы напрямую просматриваете STL-файл в GitHub Enterprise Server, вы можете:

  • Поворачивать модель с помощью перетаскивания, щелкнув левой кнопкой мыши.
  • Преобразовывать представление с помощью перетаскивания, щелкнув правой кнопкой мыши.
  • Увеличивать и уменьшать масштаб с помощью колесика мыши.
  • Изменять представление, выбирая разные режимы.

Различия

При просмотре фиксации или набора изменений, включающего STL-файл, вы сможете изучить файл до и после.

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

макет

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

Решение проблемы низкой производительности

Если этот значок отображается в углу средства просмотра, технология WebGL недоступна в браузере:

Всплывающая ошибка WebGL

WebGL позволяет использовать все преимущества аппаратного обеспечения вашего компьютера. Мы рекомендуем попробовать такие браузеры, как Chrome или Firefox, которые поставляются с включенным WebGL.

Ошибка: "Не удается отобразить"

Если модель недопустима, GitHub может не отображать файл. Кроме того, GitHub не может отображать файлы больше 10 МБ.

Внедрение модели в другое место

Чтобы отобразить трехмерный файл в другом месте в Интернете, измените этот шаблон и поместите его на любую HTML-страницу, поддерживающую JavaScript:

<script src="https://embed.github.com/view/3d/<username>/<repo>/<ref>/<path_to_file>"></script>

Например, если URL-адрес модели github.com/skalnik/secret-bear-clip/blob/master/stl/clip.stl, код внедрения будет следующим:

<script src="https://embed.github.com/view/3d/skalnik/secret-bear-clip/master/stl/clip.stl"></script>

По умолчанию внедренный отрисовщик имеет ширину 420 пикселей на 620 пикселей, но вы можете настроить выходные данные, передав переменные высоты и ширины в качестве параметров в конце URL-адреса, например ?height=300&width=500.

Примечание. ref может быть ветвью или хэшем для отдельной фиксации (например2391ae).

Отрисовка данных CSV и TSV

GitHub поддерживает отрисовку табличных данных в виде CSV- и TSV-файлов.

Пример преобразованного CSV-файла

При просмотре любой.csv или TSV-файл , зафиксированный в репозитории в экземпляр GitHub Enterprise Server автоматически отображается в виде интерактивной таблицы с заголовками и нумеровкой строк. По умолчанию мы всегда предполагаем, что первая строка является строкой заголовка.

Вы можете выполнить привязку к определенной строке, щелкнув номер строки или выбрав несколько строк, удерживая клавишу SHIFT. Просто скопируйте URL-адрес и отправьте его другу.

Поиск данных

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

Поиск значений

Обработка ошибок

Иногда CSV-или TSV-файлы могут не отрисовываться. В этих случаях в нижней части необработанного текста появится поле с указанием предполагаемой ошибки.

Сообщение об ошибке отрисовки CSV-файла

Ниже перечислены распространенные ошибки.

  • Несовпадение количества столбцов. В каждой строке должно быть одинаковое количество разделителей, даже если ячейка пуста
  • Превышение размера файла. Отрисовка работает только для файлов размером до 512 КБ. Более крупные файлы замедляют браузер.

Отрисовка PDF-документов

GitHub поддерживает отрисовку PDF-документов.

Отрисованный PDF-документ

В настоящее время ссылки в PDF-файлах игнорируются.

Отрисовка различий в текстовых документах

Фиксации и запросы на вытягивание, включающие текстовые документы, могут представлять эти документы с исходным и отрисованным представлениями.

В исходном представлении отображается введенный необработанный текст, в то время как отрисованное представление показывает, как этот текст будет выглядеть после отрисовки на GitHub Enterprise Server. Например, это может быть разница между отображением **bold** в Markdown и полужирным шрифтом в отрисованном представлении.

Отрисовка текста поддерживается для отрисованных документов, поддерживаемых github/markup:

  • Markdown
  • AsciiDoc
  • Textile
  • ReStructuredText
  • Rdoc
  • Организатор
  • Creole
  • MediaWiki
  • Pod

Значок листа бумаги для просмотра отрисованного текстового документа

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

Отрисованные изменения текстового документа

Отключение отрисовки Markdown

При просмотре файла Markdown можно щелкнуть в верхней части файла, чтобы отключить обработку файлов Markdown и просмотреть источник файла.

Отображение файла Markdown как источника

Отключение обработки файлов Markdown позволяет использовать функции просмотра источника, такие как связывание строк, что невозможно при просмотре обработанных файлов Markdown.

Визуализация изменений атрибутов

Мы предоставляем подсказку, описывающую изменения атрибутов, которые не были бы видны в отрисованном документе. Например, если URL-адрес ссылки меняется с одного веб-сайта на другой, мы отобразим подсказку следующим образом:

Отрисованные изменения атрибута prose

Комментирование изменений

Комментарии к фиксациям можно добавлять только в файлы в исходном представлении построчно.

Связывание с заголовками

Как и в случае с другими отрисованными текстовыми документами, при наведении указателя мыши на заголовок в документе создается значок ссылки. Вы можете указать читателям различий отрисованного текста на конкретные разделы.

Просмотр сложных различий

Некоторые запросы на вытягивание включают большое количество изменений с большими сложными документами. Если анализ изменений занимает слишком много времени, GitHub Enterprise Server не всегда может создать отрисованное представление изменений. В этом случае при нажатии кнопки отрисовки появится сообщение об ошибке.

Сообщение, когда представление не может быть отрисовано

Вы по-прежнему можете использовать исходное представление для анализа и комментирования изменений.

Просмотр HTML-элементов

Мы не поддерживаем напрямую отрисованные представления фиксаций в HTML-документах. Некоторые форматы, такие как Markdown, позволяют внедрять произвольный HTML-код в документ. Если эти документы отображаются на GitHub Enterprise Server, некоторые из внедренных HTML могут отображаться в предварительном просмотре, а некоторые (например, внедренное видео YouTube) не могут.

Как правило, отрисованные представления изменений документа, содержащего внедренный HTML, будут отображать изменения элементов, поддерживаемых в представлении GitHub Enterprise Serverдокумента. Изменения в документах, содержащих внедренный HTML, всегда следует проверять как в представлениях отрисовки, так и в исходных представлениях для полноты.

Сопоставление файлов GeoJSON/TopoJSON на GitHub

GitHub Enterprise Server поддерживает отрисовку файлов карты GeoJSON и TopoJSON в репозиториях GitHub Enterprise Server. Просто зафиксируйте файл, как обычно, используя расширение .geojson или .topojson. Файлы с расширением .json также поддерживаются, но только в том случае, если для type задано значение FeatureCollection, GeometryCollectionили topology. Затем перейдите по пути к файлу GeoJSON/TopoJSON на сайте GitHub.com.

Щелкнув значок бумаги справа, вы также увидите изменения, внесенные в этот файл в рамках фиксации.

Снимок экрана: переключатель исходного представления

Тип геометрического объекта

Карты в GitHub Enterprise Server используют Leaflet.js и поддерживают все геометрические типы, описанные в спецификации geoJSON (Point, LineString, Polygon, MultiPoint, MultiLineString, MultiPolygon и GeometryCollection). Файлы TopoJSON должны иметь тип Topology и соответствовать спецификации TopoJSON.

Функции стиля

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

  • marker-size - small, medium или large
  • marker-color — допустимый шестнадцатеричный код цвета RGB
  • marker-symbol — идентификатор значка из проекта Maki или одна буква или цифра (a-z или 0-9).
  • stroke — цвет линии или края многоугольника (RGB)
  • stroke-opacity — непрозрачность линии или края многоугольника (0,0–0,1)
  • stroke-width — ширина линии или края многоугольника
  • fill — цвет внутренней части многоугольника (RGB)
  • fill-opacity — непрозрачность внутренней части многоугольника (0,0–1,0)

Дополнительные сведения см. в открытой спецификации simplestyle версии 1.1.0.

Внедрение карты в другое место

Хотите, чтобы карта GeoJSON была доступна в другом месте, не только на GitHub Enterprise Server? Просто измените этот шаблон и поместите его на любую HTML-страницу, поддерживающую JavaScript (например, GitHub Pages):

<script src="https://embed.github.com/view/geojson/<username>/<repo>/<ref>/<path_to_file>"></script>

Например, если URL-адрес карты — github.com/benbalter/dc-wifi-social/blob/master/bars.geojson, код внедрения будет следующим:

<script src="https://embed.github.com/view/geojson/benbalter/dc-wifi-social/master/bars.geojson"></script>

По умолчанию внедренная карта имеет размер 420 x 620 пикселей, но вы можете настроить выходные данные, передав переменные высоты и ширины в качестве параметров в конце URL-адреса, например ?height=300&width=500.

Примечание. ref может быть ветвью или хэшем для отдельной фиксации (например2391ae).

Кластеризация

Если карта содержит большое количество маркеров (более 750), GitHub автоматически кластеризует ближайшие маркеры при малом приближении. Просто щелкните кластер или увеличьте масштаб, чтобы просмотреть отдельные маркеры.

Изменения базовой карты

Данные базовой карты (названия улиц, дороги и т. д.) управляются OpenStreetMap, совместным проектом по созданию бесплатной редактируемой карты мира. Если вы заметили ошибку, просто зарегистрируйтесь и отправьте исправление, ведь это проект с открытым кодом.

Устранение неполадок

Если у вас возникли проблемы с отрисовкой файлов GeoJSON, убедитесь, что у вас есть действительный файл GeoJSON, запустив его с помощью анализатора кода GeoJSON. Если точки не отображаются там, где вы ожидаете (например, в середине океана), скорее всего, данные находятся в проекции, которая в настоящее время не поддерживается. В настоящее время GitHub Enterprise Server поддерживает только проекцию urn:ogc:def:crs:OGC:1.3:CRS84.

Кроме того, если размер файла .geojson особенно велик (более 10 МБ), его невозможно отрисовать в браузере. В этом случае вы увидите примерно следующее сообщение:

Большой файл

Возможно, данные по-прежнему можно отрисовать, преобразовав файл .geojson в TopoJSON, формат сжатия, который в некоторых случаях может уменьшить размер файлов до 80 %. Конечно, вы всегда можете разбить файл на небольшие блоки (например, по состоянию или по годам) и хранить данные в репозитории виде нескольких файлов.

Дополнительные материалы

Работа с файлами Jupyter Notebook в GitHub

При добавлении файлов Jupyter Notebook или IPython Notebook с расширением IPYNB в экземпляр GitHub Enterprise Server они будут отображаться в виде статических HTML-файлов в репозитории.

Интерактивные функции записной книжки, такие как пользовательские графики JavaScript, не будут работать в репозитории в экземпляр GitHub Enterprise Server. Пример см. в разделе Связывание и Interactions.ipynb.

Чтобы просмотреть записную книжку Jupyter с отрисованным содержимым JavaScript или поделиться файлами записной книжки с другими пользователями, можно использовать nbviewer. Пример см. в файле Связывание Interactions.ipynb, отрисованном в nbviewer.

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

Устранение неполадок

Если у вас возникли проблемы с отрисовкой файлов Jupyter Notebook в статическом HTML-коде, вы можете преобразовать файл локально в командной строке с помощью команды nbconvert:

$ jupyter nbconvert --to html NOTEBOOK-NAME.ipynb

Дополнительные материалы