{"meta":{"title":"Работа с файлами, не связанными с кодом","intro":"GitHub поддерживает отрисовку и разбиение в ряде форматов файлов, отличных от кода.","product":"Репозитории","breadcrumbs":[{"href":"/ru/repositories","title":"Репозитории"},{"href":"/ru/repositories/working-with-files","title":"Работа с файлами"},{"href":"/ru/repositories/working-with-files/using-files","title":"Использование файлов"},{"href":"/ru/repositories/working-with-files/using-files/working-with-non-code-files","title":"Работа с файлами, не связанными с кодом"}],"documentType":"article"},"body":"# Работа с файлами, не связанными с кодом\n\nGitHub поддерживает отрисовку и разбиение в ряде форматов файлов, отличных от кода.\n\n## Отрисовка изображений и поиск различий\n\nGitHub может отображать несколько распространенных форматов изображений, включая PNG, JPG, GIF, PSD и SVG. Помимо простого отображения, существует несколько способов сравнения различий в версиях этих форматов изображений.\n\n> \\[!NOTE]\n>\n> * GitHub не поддерживает сравнение различий между PSD-файлами.\n> * Если вы используете браузер Firefox, SVG на GitHub может не отрисовываться.\n\n### Просмотр изображений\n\nВы можете напрямую просматривать изображения в репозитории на GitHub.\n\nВ настоящее время SVG не поддерживают встроенные скрипты и анимацию.\n\n### Просмотр различий\n\nВы можете визуально сравнивать изображения в трех разных режимах: [2-up](#2-up), [swipe](#swipe) и [onion skin](#onion-skin).\n\n#### 2-up\n\n```\n **2-up** — это режим по умолчанию, в котором вы смотрите на оба изображения. Кроме того, если в сравниваемых версиях у изображения разные размеры, отображается фактическое изменение размера. Это удобный способ для сравнения объектов разного размера, например при повышении разрешения.\n```\n\n\n\n#### Swipe\n\nВ режиме **swipe** можно сравнивать части изображения параллельно. Не уверены, изменились ли цвета между версиями? Перетащите ползунок в нужную область и визуально сравните фрагменты.\n\n\n\n#### Луковая кожура\n\nРежим **Onion skin** пригодится в ситуациях, когда элементы перемещаются на едва заметное расстояние. Например, значок сместился на два пикселя влево. Перетащите ползунок прозрачности немного назад и посмотрите, как сместились элементы.\n\n## Средство просмотра трехмерных файлов\n\nGitHub может размещать и отображать трехмерные файлы с расширением *STL* .\n\nПри просмотре непосредственно файла STL на GitHub можно:\n\n* Поворачивать модель с помощью перетаскивания, щелкнув левой кнопкой мыши.\n* Преобразовывать представление с помощью перетаскивания, щелкнув правой кнопкой мыши.\n* Увеличивать и уменьшать масштаб с помощью колесика мыши.\n* Изменять представление, выбирая разные режимы.\n\n### Решение проблемы низкой производительности\n\nЕсли вы видите в углу средства просмотра, с подсказкой \"Поддержка оборудования с питанием WebGL недоступна\", технология WebGL недоступна в браузере.\n\nWebGL позволяет использовать все преимущества аппаратного обеспечения вашего компьютера. Мы рекомендуем попробовать такие браузеры, как [Chrome](https://www.google.com/intl/en/chrome/browser/) или [Firefox](https://www.mozilla.org/en-US/firefox/new/), которые поставляются с включенным WebGL.\n\n### Ошибка: \"Не удается отобразить\"\n\nЕсли ваша модель некорректна, GitHub может не сможет отобразить файл. Кроме того, файлы объёмом более 10 МБ слишком большие для отображения на GitHub.\n\n### Внедрение модели в другое место\n\nЧтобы отобразить трехмерный файл в другом месте в Интернете, измените этот шаблон и поместите его на любую HTML-страницу, поддерживающую JavaScript:\n\n```html\n\n```\n\nНапример, если URL-адрес модели [`github.com/skalnik/secret-bear-clip/blob/master/stl/clip.stl`](https://github.com/skalnik/secret-bear-clip/blob/master/stl/clip.stl), код внедрения будет следующим:\n\n```html\n\n```\n\nПо умолчанию внедренный отрисовщик имеет ширину 420 пикселей на 620 пикселей, но вы можете настроить выходные данные, передав переменные высоты и ширины в качестве параметров в конце URL-адреса, например `?height=300&width=500`.\n\n> \\[!NOTE]\n> `ref` может быть ветвью или хэшом для отдельной фиксации (например `2391ae`).\n\n### Отрисовка в разметке Markdown\n\nСинтаксис STL ASCII можно внедрить непосредственно в Markdown. Дополнительные сведения см. в разделе [Создание схем](/ru/get-started/writing-on-github/working-with-advanced-formatting/creating-diagrams#creating-stl-3d-models).\n\n## Отрисовка данных CSV и TSV\n\nGitHub поддерживает отрисовку табличных данных в виде *.csv* (разделенных запятыми) и .*файлы tsv* (разделенные табуляции).\n\n\n\nПри просмотре любой .csv или *TSV-файл*\\_, зафиксированный в репозитории, на GitHub автоматически отображается как интерактивная таблица, а также заголовки и нумерирование строк. По умолчанию мы всегда предполагаем, что первая строка является строкой заголовка.\n\nВы можете выполнить привязку к определенной строке, щелкнув номер строки или выбрав несколько строк, удерживая клавишу SHIFT. Просто скопируйте URL-адрес и отправьте его другу.\n\n### Поиск данных\n\nЕсли вы хотите найти определенное значение в наборе данных, можно начать вводить текст в строке поиска непосредственно над файлом. Строки будут фильтроваться автоматически.\n\n### Обработка ошибок\n\nИногда CSV-или TSV-файлы могут не отрисовываться. В этих случаях сообщение отображается над необработанным текстом, предполагая, что может быть ошибка.\n\n\n\nНиже перечислены распространенные ошибки.\n\n* Несовпадение количества столбцов. В каждой строке должно быть одинаковое количество разделителей, даже если ячейка пуста\n* Превышение размера файла. Отрисовка работает только для файлов размером до 512 КБ. Более крупные файлы замедляют браузер.\n* Использование неподдерживаемых разделителей, таких как запятая вместо запятых.\n\n## Отрисовка PDF-документов\n\nGitHub поддерживает отрисовку PDF-документов.\n\nВ настоящее время ссылки в PDF-файлах игнорируются.\n\n## Отрисовка различий в текстовых документах\n\nФиксации и запросы на вытягивание, включающие текстовые документы, могут представлять эти документы с *исходным* и *отрисованным* представлениями.\n\nВ исходном представлении показан необработанный текст, который был введен, в то время как отображаемый текст будет выглядеть после отрисовки на GitHub. Например, это может быть разница между отображением `**bold**` в Markdown и **полужирным шрифтом** в отрисованном представлении.\n\nОтрисовка текста поддерживается для отрисованных документов, поддерживаемых [github/markup](https://github.com/github/markup):\n\n* Markdown\n* AsciiDoc\n* Textile\n* ReStructuredText\n* Rdoc\n* Org\n* Creole\n* MediaWiki\n* Объект pod\n\nЧтобы просмотреть изменения, внесенные в документ в рамках фиксации, щелкните .\n\n\n\nЭтот \"расширенный дифф\" выделяет код, добавленный и удаленный.\n\n\n\n### Отключение отрисовки Markdown\n\nПри просмотре файла Markdown можно щелкнуть **код** в верхней части файла, чтобы отключить отрисовку Markdown и просмотреть источник файла.\n\n\n\nОтключение обработки файлов Markdown позволяет использовать функции просмотра источника, такие как связывание строк, что невозможно при просмотре обработанных файлов Markdown.\n\n### Визуализация изменений атрибутов\n\nМы предоставляем подсказку, описывающую изменения атрибутов, которые не были бы видны в отрисованном документе. Например, если URL-адрес ссылки изменяется с одного веб-сайта на другой, мы отображаем подсказку следующим образом: \"href: /octo-org-repo/blob/BLOB-> /octo-org/octo-repo/blob/docs/CONTRIBUTING\".\n\n\n\n### Комментирование изменений\n\n```\n [Комментарии к фиксациям](/pull-requests/collaborating-with-pull-requests/reviewing-changes-in-pull-requests/commenting-on-a-pull-request) можно добавлять только в файлы в _исходном_ представлении построчно.\n```\n\n### Связывание с заголовками\n\nКак и в случае с [другими отрисованными текстовыми документами](/ru/repositories/managing-your-repositorys-settings-and-features/customizing-your-repository/about-readmes), при наведении указателя мыши на заголовок в документе создается значок ссылки. Вы можете указать читателям различий отрисованного текста на конкретные разделы.\n\n### Просмотр сложных различий\n\nНекоторые запросы на вытягивание включают большое количество изменений с большими сложными документами. Если для анализа изменений требуется слишком много времени, GitHub не всегда может создавать отрисованное представление изменений. В этом случае при нажатии кнопки отрисовки появится сообщение об ошибке.\n\nВы по-прежнему можете использовать исходное представление для анализа и комментирования изменений.\n\n### Просмотр HTML-элементов\n\nМы не поддерживаем напрямую отрисованные представления фиксаций в HTML-документах. Некоторые форматы, такие как Markdown, позволяют внедрять произвольный HTML-код в документ. Если эти документы отображаются на GitHub, некоторые из этих внедренных HTML можно отображать в предварительной версии, в то время как некоторые (например, внедренное видео YouTube) не могут.\n\nКак правило, отрисованные представления изменений в документе с внедренным HTML-кодом будут отображать изменения элементов, поддерживаемых в представлении GitHub. Изменения в документах, содержащих внедренный HTML, всегда следует проверять как в представлениях отрисовки, так и в исходных представлениях для полноты.\n\n## Сопоставление файлов GeoJSON/TopoJSON на GitHub\n\nGitHub поддерживает отрисовку файлов карты GeoJSON и TopoJSON в репозиториях GitHub . Зафиксируйте файл, как обычно, используя расширение `.geojson` или `.topojson`. Файлы с расширением `.json` также поддерживаются, но только в том случае, если для `type` задано значение `FeatureCollection`, `GeometryCollection`или `topology`. Затем перейдите к пути файла GeoJSON/TopoJSON на GitHub.\n\n### Тип геометрического объекта\n\nКарты на GitHub используют [Leaflet.js](http://leafletjs.com) и поддерживают все типы геометрии, описанные в [спецификации](http://www.geojson.org/geojson-spec.html) geoJSON (Point, LineString, Polygon, MultiPoint, MultiLineString, MultiLineString, MultiPolygon и GeometryCollection). Файлы TopoJSON должны иметь тип Topology и соответствовать [спецификации TopoJSON](https://github.com/mbostock/topojson/wiki/Specification).\n\n### Внедрение карты в другое место\n\nХотите сделать карту GeoJSON доступной, кроме GitHub? Просто измените этот шаблон и поместите его на любую HTML-страницу, поддерживающую JavaScript (например, [GitHub Pages](https://pages.github.com)):\n\n```html\n\n```\n\nНапример, если URL-адрес карты — [github.com/benbalter/dc-wifi-social/blob/master/bars.geojson](https://github.com/benbalter/dc-wifi-social/blob/master/bars.geojson), код внедрения будет следующим:\n\n```html\n\n```\n\nПо умолчанию внедренная карта имеет размер 420 x 620 пикселей, но вы можете настроить выходные данные, передав переменные высоты и ширины в качестве параметров в конце URL-адреса, например `?height=300&width=500`.\n\n> \\[!NOTE]\n> `ref` может быть ветвью или хэшом для отдельной фиксации (например `2391ae`).\n\n### Карты в Markdown\n\nВы можете внедрить GeoJSON и TopoJSON непосредственно в Markdown. Дополнительные сведения см. в разделе [Создание схем](/ru/get-started/writing-on-github/working-with-advanced-formatting/creating-diagrams#creating-geojson-and-topojson-maps).\n\n### Кластеризация\n\nЕсли на вашей карте много маркеров (примерно более 750), GitHub автоматически сгруппирует ближайшие маркеры на более высоких уровнях масштабирования. Просто щелкните кластер или увеличьте масштаб, чтобы просмотреть отдельные маркеры.\n\n### Изменения базовой карты\n\nДанные базовой карты (названия улиц, дороги и т. д.) управляются [OpenStreetMap](http://www.openstreetmap.org/), совместным проектом по созданию бесплатной редактируемой карты мира. Если заметите, что что-то не так, ведь это open source, просто [зарегистрируйтесь](https://www.openstreetmap.org/user/new) и отправьте исправление.\n\n### Устранение неполадок с файлами GeoJSON/TopoJSON\n\nЕсли у вас возникли проблемы с отрисовкой файлов GeoJSON, убедитесь, что у вас есть действительный файл GeoJSON, запустив его с помощью [анализатора кода GeoJSON](http://geojsonlint.com/). Если точки не отображаются, где вы ожидаете (например, в середине океана), скорее всего, данные находятся в проекции, которая в настоящее время не поддерживается. В настоящее время GitHub поддерживает только проекцию `urn:ogc:def:crs:OGC:1.3:CRS84` .\n\nКроме того, если размер файла `.geojson` особенно велик (более 10 МБ), его невозможно отрисовать в браузере. Если это так, вы, как правило, увидите сообщение, которое говорит, что мы не можем показывать файлы, которые большие.\n\nВозможно, данные по-прежнему можно отрисовать, преобразовав файл `.geojson` в [TopoJSON](https://github.com/mbostock/topojson), формат сжатия, который в некоторых случаях может уменьшить размер файлов до 80 %. Конечно, вы всегда можете разбить файл на небольшие блоки (например, по состоянию или по годам) и хранить данные в репозитории виде нескольких файлов.\n\n### Дополнительные сведения о GeoJSON/TopoJSON\n\n* [Azure Maps документация](https://docs.microsoft.com/en-us/azure/azure-maps/)\n* [Вики-сайт TopoJSON](https://github.com/mbostock/topojson/wiki)\n\n## Работа с Jupyter Notebook файлами на GitHub\n\nКогда вы добавляете Jupyter Notebook или IPython файлы Notebook с расширением *.ipynb* на GitHub, они отображаются как статические HTML-файлы в вашем репозитории.\n\nИнтерактивные функции записной книжки, такие как пользовательские графики JavaScript, не будут работать в репозитории на GitHub. Пример см. в разделе [*Связывание и Interactions.ipynb*](https://github.com/bokeh/bokeh-notebooks/blob/main/tutorial/06%20-%20Linking%20and%20Interactions.ipynb).\n\nЧтобы просмотреть записную книжку Jupyter с отрисованным содержимым JavaScript или поделиться файлами записной книжки с другими пользователями, можно использовать [nbviewer](https://nbviewer.jupyter.org/). Пример см. в файле [*Связывание Interactions.ipynb*](https://nbviewer.jupyter.org/github/bokeh/bokeh-notebooks/blob/main/tutorial/06%20-%20Linking%20and%20Interactions.ipynb), отрисованном в nbviewer.\n\nЧтобы просмотреть полностью интерактивную версию вашего Jupyter Notebook, вы можете настроить сервер ноутбуков локально. Дополнительные сведения см. в [официальной документации по Jupyter](http://jupyter.readthedocs.io/en/latest/index.html).\n\n### Устранение неполадок файлов Jupyter Notebook\n\nЕсли у вас возникают трудности с рендерингом Jupyter Notebook файлов в статическом HTML, вы можете конвертировать файл локально в командной строке, используя команду [`nbconvert`](https://github.com/jupyter/nbconvert):\n\n```shell\njupyter nbconvert --to html NOTEBOOK-NAME.ipynb\n```\n\n### Дополнительная литература о Jupyter Notebook\n\n* [Jupyter Notebook GitHub репозиторий](https://github.com/jupyter/jupyter_notebook)\n* [Коллекция записных книжек Jupyter Notebook](https://github.com/jupyter/jupyter/wiki)\n\n## Отображение файлов Mermaid на GitHub\n\nGitHub поддерживает отрисовку файлов mermaid в репозиториях. Зафиксируйте файл, как обычно, используя расширение `.mermaid` или `.mmd`. Затем перейдите по пути файла Mermaid на GitHub.\n\nНапример, при добавлении файла `.mmd` со следующим содержимым в репозиторий:\n\n```text\ngraph TD\n A[Friend's Birthday] -->|Get money| B(Go shopping)\n B --> C{Let me think}\n C -->|One| D[\"Cool Laptop\"]\n C -->|Two| E[iPhone]\n C -->|Three| F[fa:fa-car Car]\n```\n\nПри просмотре файла в репозитории он отрисовывается как блок-схема.\n\n\n\n### Устранение неполадок с файлами русалки\n\nЕсли схема вообще не отрисовывается, убедитесь, что она содержит допустимый синтаксис Mermaid Markdown, проверив схему в [динамическом редакторе Mermaid](https://mermaid.live/edit).\n\nЕсли схема отображается, но не так, как вы ожидали, можно создать новое [обсуждение GitHub Community](https://github.com/orgs/community/discussions/categories/general) и добавить метку `Mermaid`.\n\n#### Известные проблемы\n\n* Диаграммы последовательностей часто отображаются с дополнительной отбивкой под ними, причем размер отбивки увеличивается с размером диаграммы. Это известная проблема с библиотекой Mermaid.\n* Узлы субъектов с всплывающими меню не работают должным образом в диаграммах последовательности. Это связано с расхождениями, которые возникают в способе добавления событий JavaScript на диаграмму, когда API библиотеки Mermaid используется для отрисовки диаграммы.\n* Не все диаграммы соответствуют требованиям a11y. Это может повлиять на пользователей, которые используют средство чтения с экрана.\n\n### Mermaid в Markdown\n\nСинтаксис Mermaid можно внедрить непосредственно в Markdown. Дополнительные сведения см. в разделе [Создание схем](/ru/get-started/writing-on-github/working-with-advanced-formatting/creating-diagrams#creating-mermaid-diagrams).\n\n### Дополнительные сведения о русалки\n\n* [Документация по Mermaid.js](https://mermaid-js.github.io/mermaid/#/)\n* [Mermaid.js динамический редактор](https://mermaid.live/edit)"}