GitHub pages serving from docs and jekyll source folder config

villasv

The documentation for standard F# (following ProjectScaffold) has the following structure

- project
| - docs
| | content
| | files
| | output
| | tools

The generated docs are saved into output, which are then pushed to the gh-pages branch.

Recently, GitHub has changed the way serving pages work and now you can just serve the docs folder directly from the master branch. The problem is that the actual folder I wish to serve is docs/output.

Jekyll has a source configuration that allow me to do this locally. My docs/_config.yml is just:

source: output

Which works fine if I run jekyll serve in the docs folder locally. But after pushing to GitHub, the pages are still served under /output prefix.

So apparently GitHub is overriding the source option. Is there anyway this can be worked out?

David Jacquel

Is Jekyll's documentation unclear. Yes.

New github pages publication branch/folder :

Available options are (doc) :

  • gh-pages branch
  • master branch
  • master branch /docs folder
  • Disable GitHub Pages.

Three first options defines your root publication folder.

Github pages uses this root folder to generate your site. You cannot override source key in your _config.yml.

Your can store your sources in a _docs folder and output in docs

- project
| - _docs
| | content
| | files
| | tools
|
| - docs << output here

Este artigo é coletado da Internet.

Se houver alguma infração, entre em [email protected] Delete.

editar em
0

deixe-me dizer algumas palavras

0comentários
loginDepois de participar da revisão

Artigos relacionados

GitHub Pages: README.md in docs folder

Can I access metadata from a third-party GitHub repo from a Jekyll site on github-pages?

running jekyll locally on a github pages site project

Unable to set favicon using Jekyll and github pages

GitHub Pages (jekyll blog) showed 404

publish dist folder to github pages

Jekyll - link to posts from pages

Django - serving a SPA from static folder

Github Pages e Jekyll permalinks indo para caminhos diferentes

GitHub Pages que Jekyll não constrói

Is the gemfile.lock file needed in a Jekyll site hosted with Github Pages?

Receiving 404 error for assets in Github Pages Jekyll site

Get a blank page after pushing a site using Github pages with Jekyll

As barras finais no site Jekyll + GitHub Pages causam 404

Jekyll Now GitHub Pages, Tables Não Show

Jekyll Now GitHub Pages, Tables don't show up

Como separar os posts por páginas no Jekyll GitHub Pages?

nginx serving 404 pages

Jekyll/github pages issue: URL without trailing slash is loading an old/ out-of-date version of github site

is it possible to push a git repository to a folder of another repo (for example, github pages)?

How do I serve a Github page through a custom domain when the content is stored in the docs folder?

Setting up Github Pages from a forked repo

Página 404 não funciona com permalink: bastante usando GitHub Pages + Jekyll

Como adicionar vários conteúdos em uma pasta de coleção personalizada no Jekyll for Github Pages?

GitHub Pages Tema Jekyll funcionando para páginas, mas não para postagens

Jekyll inclut ne pas fonctionner dans les pages GitHub sans modèle

Erro de sintaxe líquida para tag 'gist' com github-pages gem para Jekyll

Como instalo um dos temas Jekyll do Github Pages para visualização local?

Serving pages depending on domain name

TOP lista

quentelabel

Arquivo