MATH

[gavox]

Thanks for the good work!

I would like to use the layout for my webpage. I do need to use some math. It is possible to have it on HUGO,

https://gohugo.io/content-management/mathematics/

To use with ananke, I would need two changes:

Including a file math.html in layouts/partials/math.html (step2 of that webpage)
And also modifiying layouts/_default/baseof.html (step 3 of that webpage).

Could you please include those changes in ananke?

(I have included them in my local version, and it compiles, but when I try to upload it to the webserver it downloads ananke from github and my changes are lost, so my webpage does not render math)

Thanks!

[davidsneighbour]

Hi @gavox, I moved your issue to the Discussion forum, as it's more about how to use Hugo and/or the theme and not a bug in the theme.

First of all: If you have "local changes" to any theme, you do that in your root project folder. If the theme has a file themes/themename/layouts/_default/baseof.html then you can override it by having a copy of it (with your changes) in layouts/_default/baseof.html without having it overridden by theme updates.

After you did that try uploading your site to the webserver and see if the changes take place. If not, please get back here and include a link to your repository so we can debug this issue.

We will most probably not being adding new features in the near future, so overriding the theme files with your changes is the way to go.

[gavox]

Hello, @davidsneighbour

The issue is as follows. I am using a hosting site called sourcehut to host my website. The address is: git.sr.ht. The thing is, I use git as a version control of my website. Now, the way hugo is configured, it takes the version of ananke out of your repo, not on my local files. So, when I make local changes they get added to my local branch of ananke, and therefore when I try to compile it from the werver it does not go through.

does it make sense?

This is a copy of the log:

Cloning into 'gavox.srht.site'...
+ cd gavox.srht.site
+ git checkout -q 833f372cba2f8dc6d076f57820d896bf25711d40
+ cd gavox.srht.site
+ git submodule update --init --recursive
Submodule 'themes/ananke' (https://github.com/theNewDynamic/gohugo-theme-ananke.git) registered for path 'themes/ananke'
Submodule 'themes/hugo-book' (https://github.com/alex-shpak/hugo-book) registered for path 'themes/hugo-book'
Submodule 'themes/hugo-texify3' (https://github.com/michaelneuper/hugo-texify3.git) registered for path 'themes/hugo-texify3'
Cloning into '/home/build/gavox.srht.site/themes/ananke'...
Cloning into '/home/build/gavox.srht.site/themes/hugo-book'...
Cloning into '/home/build/gavox.srht.site/themes/hugo-texify3'...
fatal: remote error: upload-pack: not our ref 10542a08a5ed7c7aa9240ad37c3200cba80ce28a
fatal: Fetched in submodule path 'themes/ananke', but it did not contain 10542a08a5ed7c7aa9240ad37c3200cba80ce28a. Direct fetching of that commit failed.
[#1337008] 2024/09/25 20:06:47 Build failed.`

Here 10542a08a5ed7c7aa9240ad37c3200cba80ce28a is my local branch of ananke. As it is not on github, compilation on sourcehut fails. But, since ananke is added as a submodule, my local changes get committed into the ananke tree, locally.

There is another way to compile the website, that is use hugo locally and upload the website to the server. That is what I am doing now. This "works", but the changes I make to the module are not really backed up anywhere. So not optimal.

That is why I proposed the changes to the module. I urge you to consider them. First is to add the file layouts/partials/math.html, with this text:

<script id="MathJax-script" async src="https://cdn.jsdelivr.net/npm/mathjax@3/es5/tex-chtml.js"></script>
<script>
  MathJax = {
    tex: {
      displayMath: [['\\[', '\\]'], ['$$', '$$']],  // block
      inlineMath: [['\\(', '\\)']]                  // inline
    }
  };
</script>

The second is to add the following code:

  {{ if .Param "math" }}
    {{ partialCached "math.html" . }}
  {{ end }}

to the file layouts/_default/baseof.html

I understand this may not be possible, and maybe the code is frozen, but that's the proposal.

tx.

[davidsneighbour]

I developed a hook system that allows users/developers to define locations in the templates where they can "hook" their layout files. Your plans would be perfect to test this out. It will take some time though to get to it.

I still think we are not at the same level in regards to "overriding modules". Your website is in a Git repository and in THAT repository you can have a layouts folder that can mirror the layouts folders of the modules. You put your changes into that folder (only the changes) and this will override their counterpart in the modules.

Example: You have a change to themes/ananke/layouts/default/_baseof.html? Copy the original file into layouts/default/_baseof.html of your own repository and add your changes there. Add and commit that to your git repository. This way your online building process will use those changes.

Add me to your repo if it is not public and I'll send a PR that examples that.

[gavox]

That sounds great Patrick, thanks.

This is the repo: https://git.sr.ht/~gavox/gavox.srht.site
It is hosted at sourcehut. Maybe you need to create an account there in order to submit changes. It is public.
(sourcehut is great, btw).