Могу ли я рендерить HTML на GitLab? - PullRequest
1 голос
/ 09 апреля 2019

GitLab не отображает HTML для меня, а просто отображает исходный код:

enter image description here

Справочная информация: я использовал sphinx для генерации HTML ипытался показать документ на GitLab.

Я посмотрел на репозитории других проектов, таких как pandas, sphinx.Они имеют только .rts файлы в хранилище, но не HTML-файлы.Я предполагаю, что они генерируют HTML для своих сайтов, но не загружают в Git.

У меня нет сайта, и я хочу показать документ на GitLab.Есть способ сделать это?Или я должен генерировать другие форматы (кроме HTML, например, PDF) вместо этого?

1 Ответ

2 голосов
/ 09 апреля 2019

Прежде всего, Git и такие продукты, как GitLab и GitHub - это разные вещи.Git никогда ничего не рендерит;это система контроля версий.У него нет веб-интерфейса.

Во-вторых, основной продукт GitLab не предполагает для рендеринга чего-либо.Это не веб-хостинг, это инструмент для размещения, обмена и управления Git-репозиториями.Однако вы можете попробовать GitLab Pages :

GitLab Pages - это функция, позволяющая публиковать статические веб-сайты непосредственно из хранилища в GitLab.

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

Страницы доступны бесплатно для всех пользователей GitLab.com, а также для самоуправляемых экземпляров (GitLab Core, Starter, Premium и Ultimate).

GitLab Pages будет публиковать контент из каталога public/ вашего репозитория, поэтому вы должны переместить туда свои файлы.Вам также понадобится файл .gitlab-ci.yml в корне вашего репозитория, содержащий что-то вроде

image: alpine:latest

pages:
  stage: deploy
  script:
  - echo 'Nothing to do...'
  artifacts:
    paths:
    - public
  only:
  - master

(взято из примера репозитория ).Добавьте этот файл, затем подтвердите и нажмите.После завершения развертывания ваш сайт должен быть доступен по https://youruser.gitlab.io/yourproject.

Обратите внимание, что на GitHub есть аналогичный продукт (работает по-другому).

Наконец,

Я просмотрел репозитории других проектов, таких как pandas, sphinx.Они имеют только .rts файлов в хранилище, но не HTML-файлы.Я предполагаю, что они генерируют HTML для своих сайтов, но не загружают в Git.

очень вероятно, что файлы reStructured Text являются единственным источником, который существует, и что HTML являетсягенерируется из них автоматически. Сфинкс этого формата по умолчанию .Если вы заинтересованы в работе с другим форматом, таким как Markdown или reStructured Text, вы можете изучить поддержку GitLab Pages для генераторов статического сайта .

...