Comments (1)
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)
- Add CHANGELOG
- Incorporate all Rudy Yogurt Notes HOT 1
- §4.6: Amend Arrays Syntax Definition HOT 2
- §6.3: Bug in Character Script Example HOT 1
- §7.1: Grammar Definition With Dictionary Word Example HOT 4
- §12.4. Video: Typo w/ "Current Window" HOT 1
- App. B: Add Clarification About Changing Constant Globals HOT 3
- Discrepancies in Token Names and Values HOT 5
- Ch 17. Grammar: Various Problems HOT 2
- App. H: <text address> Byte Order HOT 9
- Release 1.1.0 Check-List
- Update Changelog for v1.1.0
- Enhance Styles for Hugo Syntaxes and Binary Examples
- Add Script to Create Zip Archive for Distribution
- Enable Images Previews in Coalesced AsciiDoc Book
- App. H: Tokens $7A and $7B Missing HOT 1
- SVG Diagrams via Dia: Problems & Solution
- License Information Typo
- Possible Out-Of-Date License HOT 1
Recommend Projects
-
React
A declarative, efficient, and flexible JavaScript library for building user interfaces.
-
Vue.js
🖖 Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.
-
Typescript
TypeScript is a superset of JavaScript that compiles to clean JavaScript output.
-
TensorFlow
An Open Source Machine Learning Framework for Everyone
-
Django
The Web framework for perfectionists with deadlines.
-
Laravel
A PHP framework for web artisans
-
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.
-
Visualization
Some thing interesting about visualization, use data art
-
Game
Some thing interesting about game, make everyone happy.
Recommend Org
-
Facebook
We are working to build community through open source technology. NB: members must have two-factor auth.
-
Microsoft
Open source projects and samples from Microsoft.
-
Google
Google ❤️ Open Source for everyone.
-
Alibaba
Alibaba Open Source for everyone
-
D3
Data-Driven Documents codes.
-
Tencent
China tencent open source team.
from hugo-book.