GithubHelp home page GithubHelp logo

No artifact about hugo-book HOT 1 OPEN

cavallofurioso avatar cavallofurioso commented on August 29, 2024
No artifact

from hugo-book.

Comments (1)

tajmone avatar tajmone commented on August 29, 2024

In your repository, GHPages needs to be configured to serve the website from the docs/ folder in master branch.

The build script in the repository is handled via a Bash script (docs_src/build.sh) that simply converts the final document into an HTML file in the docs/ folder: docs/index.html.

Since it's a static website, you'll also need to add a .nojekyll file in the GHPages root directory (in this repository, docs/.nojekyll) so that GHPages will disable Jekyll for the website (i.e. not wait for Markdown source files).

From the errors you mention, I get the impression you're using GitHub Actions to publish the website. If that's the case, you'll need to ensure that the above settings are correctly in place in your repository, or that you adapt them accordingly (e.g. if serving from the gh-pages branch, etc.), and that your GH Action also works accordingly, for a static website.

I can't really comment much on the errors you've mentioned, since I don't known the context were you've encountered — but it doesn't look like they are from a verbatim fork of this repository.

In any case, whether you're building the HTML book from AsciiDoc, or publishing the ready-converted file elsewhere, GHPages should have no problems handling a static HTML website, as long as you include an empty .nojekyll file in the website root. If you're not building the document from the AsciiDoc source, you shouldn't need any GitHub Actions either, just configure your repository how to serve the GHPages website (the default gh-pages branch, a custom branch, or the docs/ folder from main) and simply copy the converted document, renamed as index.html (unless you have a navigation menu and other pages) and you should be good to go.

Was any of this helpful?

from hugo-book.

Related Issues (20)

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    🖖 Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. 📊📈🎉

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google ❤️ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.