Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

How to put together the project? #93

Open
kostya-konev opened this issue Apr 3, 2023 · 4 comments
Open

How to put together the project? #93

kostya-konev opened this issue Apr 3, 2023 · 4 comments

Comments

@kostya-konev
Copy link

Very difficult theme to understand. I created new project with "hugo new site ...". Then I created folder "docuapi" inside "themes" folder and put there files from THIS github. Then I tried to launch project with "hugo server" command. It didn't work.
Then I took this configuration https://github.com/bep/docuapi/blob/master/exampleSite/config.toml which YOU provide. I put it in "config.toml" file in main directory and it STILL doesn't work.
How do I make it work?

@bep
Copy link
Owner

bep commented Apr 3, 2023

I suggest you start out by checking that you can run the exampleSite in this repo. I just tested the steps below now:

git clone https://github.com/bep/docuapi.git
cd docuapi/exampleSite
hugo server

If the above works, then your environment is OK, and you can just copy the entire exampleSite folder and adjust the settings/content.

If the above does not work, you need to provide me with whatever error you get, but note.

This theme requires a reasonably new Hugo version (the extended version) and Go installed.

@DekelDevunet
Copy link

DekelDevunet commented Apr 24, 2023

I have the same issue as @kostya-konev, when I setup the server using the following docs https://tw-docs.com/docs/static-site-generators/hugo-api/

When I installed go (brew install go) I am getting empty page when starting the server with hugo server.

I think that the issue is sourced in the go.mod file

@DekelDevunet
Copy link

For the guys who have the issue in the future for me it worked when I modified the go.mod file with the following content

module github.com/bep/docuapi/exampleSite

go 1.16

require (
	github.com/bep/docuapi/v2 v2.3.0 // indirect
	github.com/gohugoio/hugo-mod-jslibs-dist/alpinejs/v3 v3.21000.20300 // indirect
	github.com/olivernn/lunr.js v2.3.9+incompatible // indirect
	github.com/slatedocs/slate v2.13.1+incompatible // indirect
)

@modatwork
Copy link

git clone https://github.com/bep/docuapi.git
cd docuapi/exampleSite
hugo server

hugo v0.113.0 failed to start the exampleSite, the error message is

Error: command error: failed to create config from result: failed to decode config for language "en": unknown config key "blackfriday"

After upgrading to hugo v0.117.0 it works now. Maybe it is related to this issue gohugoio/hugo#11159.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

No branches or pull requests

4 participants