darktable-org / dtdocs

darktable user manual
GNU General Public License v3.0
75 stars 74 forks source link

dtdoc hugo build: no hugo-darktable-docs-theme/assets/install file #685

Open wbclay opened 3 weeks ago

wbclay commented 3 weeks ago

Trying to create a dtdocs repository to prepare a pull request to supplement the rather spare existing documentation of the "custom sort" feature as described in my issue 672. Unfortunately, I have used git very little and am totally unfamiliar with hugo and yarn.

After cloning dtdocs repository and doing git submodule update --init --recursive, I find that there is no "install" file in .../docs-theme/assets or the .../docs-pdf-theme/assets. This of course kills the "yarn install" command as instructed in dtdocs README.md.

Trying to run hugo anyway, it goes nuts with lots of "execute of template failed: template: partials/css.html:4:16: executing "partials/css.html" at : can't evaluate field Sass in type interface {}."

I find the .../dtdocs/public directory still has usable HTML, but I presume that was already there in the cloned repository and hugo won't be able to update the HTML with my markdown editorial changes until I complete the prescribed yarn processing.

Where can I find the missing "install" file for yarn?

Also, I've read the wpferguson issue 101 thread, which mentions "extended" hugo. Is that also relevant to what I'm trying to do?

paperdigits commented 3 weeks ago

You do need the extended version of Hugo.

The install file is called "package.json"

On October 31, 2024 3:35:27 AM PDT, Bill Clay @.***> wrote:

Trying to create a dtdocs repository to prepare a pull request to supplement the rather spare existing documentation of the "custom sort" feature as described in my issue 672. Unfortunately, I have used git very little and am totally unfamiliar with hugo and yarn.

After cloning dtdocs repository and doing git submodule update --init --recursive, I find that there is no "install" file in .../docs-theme/assets or the .../docs-pdf-theme/assets. This of course kills the "yarn install" command as instructed in dtdocs README.md.

Trying to run hugo anyway, it goes nuts with lots of "execute of template failed: template: partials/css.html:4:16: executing "partials/css.html" at : can't evaluate field Sass in type interface {}."

I find the .../dtdocs/public directory still has usable HTML, but I presume that was already there in the cloned repository and hugo won't be able to update the HTML with my markdown editorial changes until I complete the prescribed yarn processing.

Where can I find the missing "install" file for yarn?

Also, I've read the wpferguson issue 101 thread, which mentions "extended" hugo. Is that also relevant to what I'm trying to do?

-- Reply to this email directly or view it on GitHub: https://github.com/darktable-org/dtdocs/issues/685 You are receiving this because you are subscribed to this thread.

Message ID: @.***>