alex-shpak / hugo-book Goto Github PK

View Code? Open in Web Editor NEW

2.8K 28.0 1.1K 7.52 MB

Hugo documentation theme as simple as plain book

Home Page: https://hugo-book-demo.netlify.app

License: MIT License

HTML 50.03% JavaScript 11.43% SCSS 38.54%

hugo hugo-theme documentation

hugo-book's People

Contributors

Stargazers

Watchers

Forkers

hopher u200915986 jerryi00 shaform nickshine fredliang44 seearms eliquious mixartemev kcyarn blumenow thehonestscoop thokra jladbrook caseneuve bestsamina et0and dstarner claudiodavi hayalaso acereca sioweb deftsp bianfengweb andres-lowrie icodesign hirogwa rastandy ketriel angushe someshk robfig saikocat pidelport trendingtechnology solareenlo cawleyflower tix06 lisez craigharley identityleak sqjiang it-sun jasonfoxtrot floooh jfear toby1991 jamcha-aa menthays kubeself mavient reaandrew phdzhaoyong mbrukman thiyangt danielsig727 invinddv hackebrot bethaitman faisal-akbar faressalem chbm arbelt timani tommylike noweaver b-a0 sjqzhang stephensmitchell-forks onobeibei russbiggs twohey lancatlin o-fork sinkap arturo182 peilingjiang-dev jennablack timshadel derekstefanik shanghaikid ezzdoc rukenshia joeduffy consortium youngboy1229 olivierbeaulieu oshliaer wojtekerbetowski dakotanelson rmakinn jamesb93 qaishk orymate marylychee wss1942 fengjx eiuapp vetcher ysakanaka

hugo-book's Issues

Unable to build the site using the theme

I am using yarn package manager to install hugo. I have installed the following hugo version
Hugo Static Site Generator v0.53-8FC339DC2529FF77E494A1C12CD1FF9FBCB880A4 darwin/amd64 BuildDate: 2018-12-24T08:24:44Z

However when I try to build the site, getting the following error
ERROR 2019/01/25 11:52:51 error: failed to transform resource: TOCSS: failed to transform "book.scss" (text/x-scss): this feature is not available in your current Hugo version

Kindly assist in this regard.

Left menu foldable

Could we have foldable left menues? when you build a big structure it is rather exhausting to have so much visual noise.

Thanks in advance

Dark Theme

I've fallen in love with this theme and I'm requesting a dark theme. Apologies if this is not the right place to ask for it.

Syntax highlighting for (most common) programming languages

Hi!

Could it be possible to add syntax highlighting for presenting the code blocks nicer (e.g. Java programming language)? This could be implemented quite easily by using e.g. Prism... :)

Thanks for a great theme!

hugo server --theme hugo-book or hugo server -D gives this and shows no pages:

Building sites … WARN 2019/02/13 12:41:18 Found no layout for "taxonomyTerm", language "en", output format "HTML": create a template below /layouts with one of these filenames: categories/terms.en.html.html, categories/list.en.html.html, categories/terms.html.html, categories/list.html.html, categories/terms.en.html, categories/list.en.html, categories/terms.html, categories/list.html, taxonomy/terms.en.html.html, taxonomy/list.en.html.html, taxonomy/terms.html.html, taxonomy/list.html.html, taxonomy/terms.en.html, taxonomy/list.en.html, taxonomy/terms.html, taxonomy/list.html, _default/terms.en.html.html, _default/list.en.html.html, _default/terms.html.html, _default/list.html.html, _default/terms.en.html, _default/list.en.html, _default/terms.html, _default/list.html
WARN 2019/02/13 12:41:18 Found no layout for "taxonomyTerm", language "en", output format "HTML": create a template below /layouts with one of these filenames: tags/terms.en.html.html, tags/list.en.html.html, tags/terms.html.html, tags/list.html.html, tags/terms.en.html, tags/list.en.html, tags/terms.html, tags/list.html, taxonomy/terms.en.html.html, taxonomy/list.en.html.html, taxonomy/terms.html.html, taxonomy/list.html.html, taxonomy/terms.en.html, taxonomy/list.en.html, taxonomy/terms.html, taxonomy/list.html, _default/terms.en.html.html, _default/list.en.html.html, _default/terms.html.html, _default/list.html.html, _default/terms.en.html, _default/list.en.html, _default/terms.html, _default/list.html
WARN 2019/02/13 12:41:18 Found no layout for "home", language "en", output format "HTML": create a template below /layouts with one of these filenames: index.en.html.html, home.en.html.html, list.en.html.html, index.html.html, home.html.html, list.html.html, index.en.html, home.en.html, list.en.html, index.html, home.html, list.html, _default/index.en.html.html, _default/home.en.html.html, _default/list.en.html.html, _default/index.html.html, _default/home.html.html, _default/list.html.html, _default/index.en.html, _default/home.en.html, _default/list.en.html, _default/index.html, _default/home.html, _default/list.html

`ul a { display: block; }` causes strange layout for links in a list

If we have something like this in our content:

Here are some solutions:

*   You could go to [this site](https://example.org).
*   You could ....

The rendered content would become:

Here are some solutions:

You could go to
this site
.
You could ....

I think this might not be desirable?

In addition, the bullet points have disappeared.

Adding equations to the theme

Hi,
I started using your theme for documentation and I wonder if it is possible to render equations. So far I have been unsuccessful. I tried some of the ideas here https://bookdown.org/yihui/blogdown/templates.html but couldn't fix it.
I'm not sure if you have plans to add that capability to your theme.

BookSection: "*" should group by folder

When I configure the menu to "collect" both the book and the blog posts, these seem to appear on top of the menu and not only that, these are flat so the more blogposts, the more I push the menu down.

Can we use the folder containing them as a way to categorise?

thanks

Without TOC stil shows the TOC

Without TOC stil shows the TOC. Would be great to have no TOC example.

scss not supported

Hi,

I just tried to setup your theme. I followed the get started instructions from gohugo page, added your theme as a git submodule and ended up with the following error message:

PS C:\Users\janik\Documents\knowledge_adnovum> hugo serve
...
ERROR 2018/11/30 14:40:21 error: failed to transform resource: TOCSS: failed to transform "book.scss" (text/x-scss): this feature is not available in your current Hugo version
Total in 19 ms
Error: Error building site: logged 1 error(s)
PS C:\Users\janik\Documents\knowledge_adnovum> hugo version
Hugo Static Site Generator v0.52 windows/amd64 BuildDate: 2018-11-28T14:07:10Z

Do I need to configure something to make scss conversion possible?

enableGitInfo: true The parameter is invalid and does not work.

enableGitInfo: false The parameter is invalid. It is closed but still displayed.

Fonts not found?

Am trying out the theme on linux/firefox and am having a font issue. Is there anyway to make sure that Oxygen is used? Or is there any way to specify a different font?

Sorry if this is too simple to fix. Any help appreciated.

Otherwise the theme seems excellent.

Lots of warning while serving exampleSite

I'm getting lots of errors while trying to test it out.

Steps to reproduce:

$> hugo new site quickstart
$> cd quickstart
$> git init
$> git submodule add https://github.com/alex-shpak/hugo-book themes/hugo-book
$> cd themes/hugo-book/exampleSite
$> hugo server --themesDir ../..

These are the warnings:

Building sites … WARN 2018/12/27 16:48:48 Found no layout for "taxonomy", language "en", output format "HTML": create a template below /layouts with one of these filenames: tags/tag.en.html.html, tags/taxonomy.en.html.html, tags/list.en.html.html, tags/tag.html.html, tags/taxonomy.html.html, tags/list.html.html, tags/tag.en.html, tags/taxonomy.en.html, tags/list.en.html, tags/tag.html, tags/taxonomy.html, tags/list.html, taxonomy/tag.en.html.html, taxonomy/taxonomy.en.html.html, taxonomy/list.en.html.html, taxonomy/tag.html.html, taxonomy/taxonomy.html.html, taxonomy/list.html.html, taxonomy/tag.en.html, taxonomy/taxonomy.en.html, taxonomy/list.en.html, taxonomy/tag.html, taxonomy/taxonomy.html, taxonomy/list.html, tag/tag.en.html.html, tag/taxonomy.en.html.html, tag/list.en.html.html, tag/tag.html.html, tag/taxonomy.html.html, tag/list.html.html, tag/tag.en.html, tag/taxonomy.en.html, tag/list.en.html, tag/tag.html, tag/taxonomy.html, tag/list.html, _default/tag.en.html.html, _default/taxonomy.en.html.html, _default/list.en.html.html, _default/tag.html.html, _default/taxonomy.html.html, _default/list.html.html, _default/tag.en.html, _default/taxonomy.en.html, _default/list.en.html, _default/tag.html, _default/taxonomy.html, _default/list.html
WARN 2018/12/27 16:48:48 Found no layout for "taxonomyTerm", language "en", output format "HTML": create a template below /layouts with one of these filenames: categories/category.terms.en.html.html, categories/terms.en.html.html, categories/list.en.html.html, categories/category.terms.html.html, categories/terms.html.html, categories/list.html.html, categories/category.terms.en.html, categories/terms.en.html, categories/list.en.html, categories/category.terms.html, categories/terms.html, categories/list.html, taxonomy/category.terms.en.html.html, taxonomy/terms.en.html.html, taxonomy/list.en.html.html, taxonomy/category.terms.html.html, taxonomy/terms.html.html, taxonomy/list.html.html, taxonomy/category.terms.en.html, taxonomy/terms.en.html, taxonomy/list.en.html, taxonomy/category.terms.html, taxonomy/terms.html, taxonomy/list.html, category/category.terms.en.html.html, category/terms.en.html.html, category/list.en.html.html, category/category.terms.html.html, category/terms.html.html, category/list.html.html, category/category.terms.en.html, category/terms.en.html, category/list.en.html, category/category.terms.html, category/terms.html, category/list.html, _default/category.terms.en.html.html, _default/terms.en.html.html, _default/list.en.html.html, _default/category.terms.html.html, _default/terms.html.html, _default/list.html.html, _default/category.terms.en.html, _default/terms.en.html, _default/list.en.html, _default/category.terms.html, _default/terms.html, _default/list.html
WARN 2018/12/27 16:48:48 Found no layout for "taxonomy", language "en", output format "HTML": create a template below /layouts with one of these filenames: tags/tag.en.html.html, tags/taxonomy.en.html.html, tags/list.en.html.html, tags/tag.html.html, tags/taxonomy.html.html, tags/list.html.html, tags/tag.en.html, tags/taxonomy.en.html, tags/list.en.html, tags/tag.html, tags/taxonomy.html, tags/list.html, taxonomy/tag.en.html.html, taxonomy/taxonomy.en.html.html, taxonomy/list.en.html.html, taxonomy/tag.html.html, taxonomy/taxonomy.html.html, taxonomy/list.html.html, taxonomy/tag.en.html, taxonomy/taxonomy.en.html, taxonomy/list.en.html, taxonomy/tag.html, taxonomy/taxonomy.html, taxonomy/list.html, tag/tag.en.html.html, tag/taxonomy.en.html.html, tag/list.en.html.html, tag/tag.html.html, tag/taxonomy.html.html, tag/list.html.html, tag/tag.en.html, tag/taxonomy.en.html, tag/list.en.html, tag/tag.html, tag/taxonomy.html, tag/list.html, _default/tag.en.html.html, _default/taxonomy.en.html.html, _default/list.en.html.html, _default/tag.html.html, _default/taxonomy.html.html, _default/list.html.html, _default/tag.en.html, _default/taxonomy.en.html, _default/list.en.html, _default/tag.html, _default/taxonomy.html, _default/list.html
WARN 2018/12/27 16:48:48 Found no layout for "taxonomy", language "en", output format "HTML": create a template below /layouts with one of these filenames: categories/category.en.html.html, categories/taxonomy.en.html.html, categories/list.en.html.html, categories/category.html.html, categories/taxonomy.html.html, categories/list.html.html, categories/category.en.html, categories/taxonomy.en.html, categories/list.en.html, categories/category.html, categories/taxonomy.html, categories/list.html, taxonomy/category.en.html.html, taxonomy/taxonomy.en.html.html, taxonomy/list.en.html.html, taxonomy/category.html.html, taxonomy/taxonomy.html.html, taxonomy/list.html.html, taxonomy/category.en.html, taxonomy/taxonomy.en.html, taxonomy/list.en.html, taxonomy/category.html, taxonomy/taxonomy.html, taxonomy/list.html, category/category.en.html.html, category/taxonomy.en.html.html, category/list.en.html.html, category/category.html.html, category/taxonomy.html.html, category/list.html.html, category/category.en.html, category/taxonomy.en.html, category/list.en.html, category/category.html, category/taxonomy.html, category/list.html, _default/category.en.html.html, _default/taxonomy.en.html.html, _default/list.en.html.html, _default/category.html.html, _default/taxonomy.html.html, _default/list.html.html, _default/category.en.html, _default/taxonomy.en.html, _default/list.en.html, _default/category.html, _default/taxonomy.html, _default/list.html
WARN 2018/12/27 16:48:48 Found no layout for "taxonomy", language "en", output format "HTML": create a template below /layouts with one of these filenames: tags/tag.en.html.html, tags/taxonomy.en.html.html, tags/list.en.html.html, tags/tag.html.html, tags/taxonomy.html.html, tags/list.html.html, tags/tag.en.html, tags/taxonomy.en.html, tags/list.en.html, tags/tag.html, tags/taxonomy.html, tags/list.html, taxonomy/tag.en.html.html, taxonomy/taxonomy.en.html.html, taxonomy/list.en.html.html, taxonomy/tag.html.html, taxonomy/taxonomy.html.html, taxonomy/list.html.html, taxonomy/tag.en.html, taxonomy/taxonomy.en.html, taxonomy/list.en.html, taxonomy/tag.html, taxonomy/taxonomy.html, taxonomy/list.html, tag/tag.en.html.html, tag/taxonomy.en.html.html, tag/list.en.html.html, tag/tag.html.html, tag/taxonomy.html.html, tag/list.html.html, tag/tag.en.html, tag/taxonomy.en.html, tag/list.en.html, tag/tag.html, tag/taxonomy.html, tag/list.html, _default/tag.en.html.html, _default/taxonomy.en.html.html, _default/list.en.html.html, _default/tag.html.html, _default/taxonomy.html.html, _default/list.html.html, _default/tag.en.html, _default/taxonomy.en.html, _default/list.en.html, _default/tag.html, _default/taxonomy.html, _default/list.html
WARN 2018/12/27 16:48:48 Found no layout for "taxonomy", language "en", output format "HTML": create a template below /layouts with one of these filenames: categories/category.en.html.html, categories/taxonomy.en.html.html, categories/list.en.html.html, categories/category.html.html, categories/taxonomy.html.html, categories/list.html.html, categories/category.en.html, categories/taxonomy.en.html, categories/list.en.html, categories/category.html, categories/taxonomy.html, categories/list.html, taxonomy/category.en.html.html, taxonomy/taxonomy.en.html.html, taxonomy/list.en.html.html, taxonomy/category.html.html, taxonomy/taxonomy.html.html, taxonomy/list.html.html, taxonomy/category.en.html, taxonomy/taxonomy.en.html, taxonomy/list.en.html, taxonomy/category.html, taxonomy/taxonomy.html, taxonomy/list.html, category/category.en.html.html, category/taxonomy.en.html.html, category/list.en.html.html, category/category.html.html, category/taxonomy.html.html, category/list.html.html, category/category.en.html, category/taxonomy.en.html, category/list.en.html, category/category.html, category/taxonomy.html, category/list.html, _default/category.en.html.html, _default/taxonomy.en.html.html, _default/list.en.html.html, _default/category.html.html, _default/taxonomy.html.html, _default/list.html.html, _default/category.en.html, _default/taxonomy.en.html, _default/list.en.html, _default/category.html, _default/taxonomy.html, _default/list.html
WARN 2018/12/27 16:48:48 Found no layout for "taxonomy", language "en", output format "HTML": create a template below /layouts with one of these filenames: tags/tag.en.html.html, tags/taxonomy.en.html.html, tags/list.en.html.html, tags/tag.html.html, tags/taxonomy.html.html, tags/list.html.html, tags/tag.en.html, tags/taxonomy.en.html, tags/list.en.html, tags/tag.html, tags/taxonomy.html, tags/list.html, taxonomy/tag.en.html.html, taxonomy/taxonomy.en.html.html, taxonomy/list.en.html.html, taxonomy/tag.html.html, taxonomy/taxonomy.html.html, taxonomy/list.html.html, taxonomy/tag.en.html, taxonomy/taxonomy.en.html, taxonomy/list.en.html, taxonomy/tag.html, taxonomy/taxonomy.html, taxonomy/list.html, tag/tag.en.html.html, tag/taxonomy.en.html.html, tag/list.en.html.html, tag/tag.html.html, tag/taxonomy.html.html, tag/list.html.html, tag/tag.en.html, tag/taxonomy.en.html, tag/list.en.html, tag/tag.html, tag/taxonomy.html, tag/list.html, _default/tag.en.html.html, _default/taxonomy.en.html.html, _default/list.en.html.html, _default/tag.html.html, _default/taxonomy.html.html, _default/list.html.html, _default/tag.en.html, _default/taxonomy.en.html, _default/list.en.html, _default/tag.html, _default/taxonomy.html, _default/list.html
WARN 2018/12/27 16:48:48 Found no layout for "taxonomy", language "en", output format "HTML": create a template below /layouts with one of these filenames: tags/tag.en.html.html, tags/taxonomy.en.html.html, tags/list.en.html.html, tags/tag.html.html, tags/taxonomy.html.html, tags/list.html.html, tags/tag.en.html, tags/taxonomy.en.html, tags/list.en.html, tags/tag.html, tags/taxonomy.html, tags/list.html, taxonomy/tag.en.html.html, taxonomy/taxonomy.en.html.html, taxonomy/list.en.html.html, taxonomy/tag.html.html, taxonomy/taxonomy.html.html, taxonomy/list.html.html, taxonomy/tag.en.html, taxonomy/taxonomy.en.html, taxonomy/list.en.html, taxonomy/tag.html, taxonomy/taxonomy.html, taxonomy/list.html, tag/tag.en.html.html, tag/taxonomy.en.html.html, tag/list.en.html.html, tag/tag.html.html, tag/taxonomy.html.html, tag/list.html.html, tag/tag.en.html, tag/taxonomy.en.html, tag/list.en.html, tag/tag.html, tag/taxonomy.html, tag/list.html, _default/tag.en.html.html, _default/taxonomy.en.html.html, _default/list.en.html.html, _default/tag.html.html, _default/taxonomy.html.html, _default/list.html.html, _default/tag.en.html, _default/taxonomy.en.html, _default/list.en.html, _default/tag.html, _default/taxonomy.html, _default/list.html
WARN 2018/12/27 16:48:48 Found no layout for "taxonomyTerm", language "en", output format "HTML": create a template below /layouts with one of these filenames: tags/tag.terms.en.html.html, tags/terms.en.html.html, tags/list.en.html.html, tags/tag.terms.html.html, tags/terms.html.html, tags/list.html.html, tags/tag.terms.en.html, tags/terms.en.html, tags/list.en.html, tags/tag.terms.html, tags/terms.html, tags/list.html, taxonomy/tag.terms.en.html.html, taxonomy/terms.en.html.html, taxonomy/list.en.html.html, taxonomy/tag.terms.html.html, taxonomy/terms.html.html, taxonomy/list.html.html, taxonomy/tag.terms.en.html, taxonomy/terms.en.html, taxonomy/list.en.html, taxonomy/tag.terms.html, taxonomy/terms.html, taxonomy/list.html, tag/tag.terms.en.html.html, tag/terms.en.html.html, tag/list.en.html.html, tag/tag.terms.html.html, tag/terms.html.html, tag/list.html.html, tag/tag.terms.en.html, tag/terms.en.html, tag/list.en.html, tag/tag.terms.html, tag/terms.html, tag/list.html, _default/tag.terms.en.html.html, _default/terms.en.html.html, _default/list.en.html.html, _default/tag.terms.html.html, _default/terms.html.html, _default/list.html.html, _default/tag.terms.en.html, _default/terms.en.html, _default/list.en.html, _default/tag.terms.html, _default/terms.html, _default/list.html
WARN 2018/12/27 16:48:48 Found no layout for "taxonomy", language "en", output format "HTML": create a template below /layouts with one of these filenames: tags/tag.en.html.html, tags/taxonomy.en.html.html, tags/list.en.html.html, tags/tag.html.html, tags/taxonomy.html.html, tags/list.html.html, tags/tag.en.html, tags/taxonomy.en.html, tags/list.en.html, tags/tag.html, tags/taxonomy.html, tags/list.html, taxonomy/tag.en.html.html, taxonomy/taxonomy.en.html.html, taxonomy/list.en.html.html, taxonomy/tag.html.html, taxonomy/taxonomy.html.html, taxonomy/list.html.html, taxonomy/tag.en.html, taxonomy/taxonomy.en.html, taxonomy/list.en.html, taxonomy/tag.html, taxonomy/taxonomy.html, taxonomy/list.html, tag/tag.en.html.html, tag/taxonomy.en.html.html, tag/list.en.html.html, tag/tag.html.html, tag/taxonomy.html.html, tag/list.html.html, tag/tag.en.html, tag/taxonomy.en.html, tag/list.en.html, tag/tag.html, tag/taxonomy.html, tag/list.html, _default/tag.en.html.html, _default/taxonomy.en.html.html, _default/list.en.html.html, _default/tag.html.html, _default/taxonomy.html.html, _default/list.html.html, _default/tag.en.html, _default/taxonomy.en.html, _default/list.en.html, _default/tag.html, _default/taxonomy.html, _default/list.html

Running on a macOS with a Hugo installed from Homebrew. Concretely i'm using the version Hugo Static Site Generator v0.53/extended darwin/amd64

Git submodule command not working

git submodule add https://github.com/alex-shpak/hugo-book themes/book
fatal: Not a git repository (or any of the parent directories): .git

Is there any way I can set how deep the level is to show the TOC at right side?

My doc has a deep hierarchy which contains level 5 or 6 headings sometimes. But I only want to show the TOC with 2 or 3 levels of the heading. What can I do to the setting and code, I can't find where the var {{ .Page.TableOfContents }} come from, which is used to generate toc in toc.html file.

about homepage

sir, I like your theme very, and forked it, but where is the homepage,why the homepage is readme?
thanks!

Error: Error building site: template: __bd79e2c7beb3b2743763ee42ab922d26:54: function "display" not defined

git submodule add ...

hugo server --theme book

then:

Error: Error building site: template: __bd79e2c7beb3b2743763ee42ab922d26:54: function "display" not defined

Can I collapse the left menu at the second or third level?

Toc in mobile browsers

Hi and congrats for your really nice theme.

I am preparing a website and I noticed that when using the mobile theme, the table of content disappears.
Is there any way to show it, ex. in the beginning of the document or anywhere else?
Thank you in advance.
Mike

Menu on the left realigns after click on menu item.

Hi,

If I click on menu item on the left, the entire page refreshes and the menu is scrolled to the top. It doesnot maintain the position of where it was clicked initially. This leads to a bad UX, where the user has to scroll again all the way down on the menu to go back the previous position. Kindly fix the issue.

Suggestion, Add footer partial

It would be great to have a footer available as this is handy to me for debugging purposes, as in injecting a debug footer when required.

A structure a bit like this is what I mean... thanks

<!DOCTYPE html>
<html>
  {{- partial "head.html" . -}}
  <body>
    {{- partial "header.html" . -}}
    {{- block "main" . }}{{- end }}
    {{- partial "footer.html" . -}}
  </body>
</html>

Documentation Improvements

Would be great if the docs could provide some info on customising the theme as well, from the ratio of the manu, fonts used, custom CSS, custom date formating and others.

Thanks.

Math formula support

I really love your work and try to build a note site based on this theme for my learning record. Have you planed to add math formula support into your great theme?
Or if you could give me some suggestions, I am glad to do it myself but cant find a way yet...
Sincere thanks.

Hugo Book + Bootstrap

I am keen in adding some more graphical tools to the content and found Bootstrap 4.3 could be great, I followed the installation notes and injected these 3 lines using the head injection mechanism.

Created a head.html on my website's layout/partials/docs/inject/head.html

<link href="https://stackpath.bootstrapcdn.com/bootstrap/4.3.1/css/bootstrap.min.css" rel="stylesheet" integrity="sha384-ggOyR0iXCbMQv3Xipma34MD+dH/1fQ784/j6cY/iJTQUOhcWr7x9JvoRxT2MZw1T" crossorigin="anonymous">

<link href="https://stackpath.bootstrapcdn.com/bootstrap/4.3.1/css/bootstrap.min.css" rel="stylesheet" integrity="sha384-ggOyR0iXCbMQv3Xipma34MD+dH/1fQ784/j6cY/iJTQUOhcWr7x9JvoRxT2MZw1T" crossorigin="anonymous">

<script src="https://stackpath.bootstrapcdn.com/bootstrap/4.3.1/js/bootstrap.min.js" integrity="sha384-JjSmVgyd0p3pXB1rRibZUAYoIIy6OrQ6VrjIEaFf/nJGzIxFDsf4x0xIM+B07jRM" crossorigin="anonymous"></script>

And when i run the website the widgets I use work as desired, only problem is that the fonts and general proportions of the page amongst other things seem to be broken now.

My questions are;

Is this the correct approach?
Can I do this without breaking your design?
Does this mean the normalize.min.css is not useless? How do I correct the new design to make it look like yours?

Thanks for the help, I hope I can contribute in the near future.
jb

When menu is too long, users won't be able to see items at the bottom.

I am trying to move my docusaurus book to hugo-book.
Actually, I found the layouts for the two look very similar.

However, while docusaurus handles a long menu very well.
Currently hugo-book does not seem to behave well in such situations.

Is it possible to improve upon this? Thanks.

Support Google Analytics?

Hi,

Hugo has built-in Google Analytics support: https://gohugo.io/templates/internal/.
Is it possible to enable it for hugo-book?

Thanks.

The site-name link point to localhost:1313

when upload to server, the site-name link point to "localhost:1313".
can anybody help? thanks.

Missing files in layouts error while using theme

I was trying to use this theme just for testing and playing with hugo but i seem to be getting an error using the theme with the defaults.
I did the following

hugo new site my-site
cd my-site
git init
git submodule add https://github.com/alex-shpak/hugo-book themes/book
hugo server --theme book

And i got the following error

Building sites … WARN 2019/01/21 13:23:53 Found no layout for "taxonomyTerm", language "en", output format "HTML": create a template below /layouts with one of these filenames: categories/terms.en.html.html, categories/list.en.html.html, categories/terms.html.html, categories/list.html.html, categories/terms.en.html, categories/list.en.html, categories/terms.html, categories/list.html, taxonomy/terms.en.html.html, taxonomy/list.en.html.html, taxonomy/terms.html.html, taxonomy/list.html.html, taxonomy/terms.en.html, taxonomy/list.en.html, taxonomy/terms.html, taxonomy/list.html, _default/terms.en.html.html, _default/list.en.html.html, _default/terms.html.html, _default/list.html.html, _default/terms.en.html, _default/list.en.html, _default/terms.html, _default/list.html
WARN 2019/01/21 13:23:53 Found no layout for "home", language "en", output format "HTML": create a template below /layouts with one of these filenames: index.en.html.html, home.en.html.html, list.en.html.html, index.html.html, home.html.html, list.html.html, index.en.html, home.en.html, list.en.html, index.html, home.html, list.html, _default/index.en.html.html, _default/home.en.html.html, _default/list.en.html.html, _default/index.html.html, _default/home.html.html, _default/list.html.html, _default/index.en.html, _default/home.en.html, _default/list.en.html, _default/index.html, _default/home.html, _default/list.html
WARN 2019/01/21 13:23:53 Found no layout for "taxonomyTerm", language "en", output format "HTML": create a template below /layouts with one of these filenames: tags/terms.en.html.html, tags/list.en.html.html, tags/terms.html.html, tags/list.html.html, tags/terms.en.html, tags/list.en.html, tags/terms.html, tags/list.html, taxonomy/terms.en.html.html, taxonomy/list.en.html.html, taxonomy/terms.html.html, taxonomy/list.html.html, taxonomy/terms.en.html, taxonomy/list.en.html, taxonomy/terms.html, taxonomy/list.html, _default/terms.en.html.html, _default/list.en.html.html, _default/terms.html.html, _default/list.html.html, _default/terms.en.html, _default/list.en.html, _default/terms.html, _default/list.html
ERROR 2019/01/21 13:23:53 error: failed to transform resource: TOCSS: failed to transform "book.scss" (text/x-scss): this feature is not available in your current Hugo version
Total in 2 ms
Error: Error building site: logged 1 error(s)

normalize.min.css.map 404

Local server runs throw a 404 for a normalize.min.css.map file. Where is this error coming from? It's not grave in that it only pops up in the background on a local server (in the console) and doesn't appear on a live site.

I tried deleting line 2 in static/normalize.min.css in hugo-book but that did nothing. Again, this is not an error, I'm just curious.

Responsivness issues in mobile view

Hi,

I am really fond of your theme and try to build a site with it.

I found that text doesn't scale properly on my phone (720x1280 screen) with vertical view. It only works with horizontal view (screenshots attached). I can't make it smaller manually (although it works with bigger displays -- I checked the behavior on 1080x2160 screen where text didn't scale automatically but could be rescaled manually to fit the screen).

Is it "fixable"?

git submodule install

hi - I am new to hugo (as in, first hour). I installed hugo on Ubuntu via the hugo.deb .

Hugo Static Site Generator v0.51 linux/amd64 BuildDate: 2018-11-07T10:10:13Z

so I go to "choose a theme" .. the README does not fit me. The one-line direction from hugo says
"Download a theme into the same-named folder". git submodule complains that the new project dir is not a git repo.

a README ought to cover the very, very beginner case well.. thanks!

Is it possible to link nested docs?

Hey, I'm trying to organize the directory structure of my docs to follow the menu hierarchy:

---
headless: true
---

- [**About**]({{< relref "/docs/about/index.md" >}})
    - [Features]({{< relref "/docs/about/features.md" >}})
    ...

But this causes the following error:

Source changed "/Users/celicoo/go/src/github.com/celicoo/docli/docs/content/menu/index.md": CREATE
ERROR 2019/02/28 09:07:03 [en] REF_NOT_FOUND: Ref "/docs/about/features.md": "/Users/celicoo/go/src/github.com/celicoo/docli/docs/content/menu/index.md:6:18": page not found

Isn't this supported?

Use this without theme

Is there anyway to use this theme for a particular "section" only and have a different theme for the rest of the site?

It would be awesome if instructions were added to readme despite it being an unorthodox case.

Css

Can you provide unminified Css please

Empty Open Page

Hi, after cloning the theme and running in local, I'm getting an empty open page.

Can I make blog posts available on root URL instead of book ?

By default, the book content, specifically "Introduction" page is root page (http://localhost:1313), blog is available under "/posts" - is it possible to configure it to get blogs posts at root level, while book under some path ?

Documentation on posts/ directory

it is not clear in the documentation that the posts/ directory must be named as such (as opposed to post/). This was not apparent when installing and led to multiple errors.

Fix Indention in Code Block

There is a slight space or two indentions of the first line in multi-line code blocks. If you remove this line from _markdown.scss, it fixes it:

padding: 0 $padding-4;

Add search bar

When the doc site grows bigger and bigger, it's hard for user to find wanted pages/docs/posts even in a hierarchy structured documentation. Therefore, a useful full text search bar is indeed needed.

Is there any way to disable Google Fonts?

I'm looking for a way to disable Google Fonts without having to replicate head-html.html. Is this possible currently?

Multi-level submenus

Is there any way to make subcategories in a category? Currently, I am using BookMenuBundle like below.
/content/menu/index.md

Math
- Calculus
  - [Basics]({{< ref "/docs/math/calculus/basics.md" >}})
  - [Advanced]({{< ref "/docs/math/calculus/advanced.md" >}})
- Statistics
  - [Basics]({{< ref "/docs/math/statistics/basics.md" >}})
Machine Learning
- Projects
  - [Keyword Extraction]({{< ref "/docs/ml/keywordextraction.md" >}})
- Theories
  - [Decision Theory]({{< ref "/docs/ml/monk/01_decision_theory.md" >}})
Deep Learning
- [Backprop]({{< ref "/docs/deeplearning/backprop.md" >}})
Linux

"Projects" and "Theories" are child categories of "Machine Learning" category.
I want to show this hierarchical structure of menu in the sidebar. It would be really nice if categories are expandable/collapsible by clicking.

Please allow relative links

I would like to serve this site from a non-root directory (kind of like example.com/hugo-book/), but when I do, it has formatting issues:

compared to this:

add images

Hi,
is it possibile to add images inside pages? Markdown syntax seems not working.
I'm using netlify-github.

thanks for the good job.

Tables are not formatted nicely

Could you please review the formatting of tables so they look nice? at the moment the table frame is not rendered at all so it looks awful.

Name	Surname
Jordi	Bares
Pedro	Almodovar

thanks in advance

Add support for blog tags and categories

Following #56 (comment)

Add support for:

Tags
Categories

Configuration documentation is incorrect by BookMenuBundle

in README.md Written:

And Enable it by settings BookMenuBundle: /docs/menu in Site configuration

BookMenuBundle: /docs/menu # not working
BookMenuBundle: /menu # is ok

In addition, it is recommended that the configuration file be written in TOML syntax uniformly, otherwise the newcomer directly copies the configuration file and does not work.

Automatically list pages when using menu bundle

I would like to have the side menu automatically list all pages under docs/ when using BookMenuBundle = "/menu". Right now it looks like I have to manually add each new page to content/menu/index.md. Is this possible?

I tried something like this but it doesn't work (I'm still a Hugo noob and learned that templates don't work in Markdown):

- [**Home**]({{< relref "/" >}})
- **Docs**
  {{ range where .Site.Pages "Dir" "docs" }}
  - [{{ .Title }}]({{< relref .File.Path >}})
  {{ end }}
- [**Blog**]({{< relref "/posts" >}})

.File.Dir and .File.Path on zero object

The terminal throws a pair of errors:

.File.Dir on zero object. Wrap it in if or with: {{ with .File }}{{ .Dir }}{{ end }}

and

.File.Path on zero object. Wrap it in if or with: {{ with .File }}{{ .Path }}{{ end }}

The former is probably from shared.html; about the latter I'm not quite sure. How would I resolve this?

Menu on the left doesnot highlight the link if on the current Page

When I am on a page by clicking on the link on the menu, the clicked link is not shown highlighted. This happens if the BookMenuBundle option is set. The .Content is rendered within menu-bundle.html partial, which gives no control to style the clicked link. Kindly assist.

Introduce shortcodes

I think to introduce some shortcodes for documentation.
If you have some ideas please post here.

What I have now in mind: