NhS3>T=86;xSAF4s4jIdY|WXc+KIXI)k|aKTF|aj@!~;ohB3AY;z`8R
zh{{$=e8|H1+>dJ*t3f9k_VzVDie*RzxL}}SwCGai?FdB#p>@xyWcm0%1
z(;>9pfBO8;DVinB7CrQbM4L2bI?+D7@>wIL(3SWKilKk^HA{?NVZV!{IAz0pb6=<4
zx`BEWWPalQkKd?y%~~DSR|_2@Yu*AIY67V$EA6)VfR9KDqI{|+CAxp@S4k1pTJmX!
z?eTRl5Oz&|Y06mG{5jK2zWd%<$R6z6@QT}gERgVqGVD+J?}y-o2>+d_es$IiBFfr%
z^RZXU>kr}4(3#l2d|~dE(W@kjSHMJI>u9e&@Z$a?yVv*^NXb0WN9X~mtXop3SOr>I
zF15g-70q&=hhD$o~qlRpq2Gixn=W2REh6wL&gmUMW1vTHclXWuKY<&rHw?q{;~=B6l7z?IEc_t0tNufKK6vT49zJJHo2jJ^K7
zG#OZWPw^0UDUP>D8c{5q|1n3@aGdDhkaHJK)NT2G0&A*fSdw)ZLnjw>5>5zbr{Kh2
z9|1oam&}}}$8`PY(ygywg4&xmvIOFY$rs8TplZi{Wb(f}M`G3M;?{z7U8ut2fE5|#
zC%@#Hgax6qn1s`3%flrZnUV;X%CmlFrCN(e15?^|!nh0bS25nRDsTKB(inditY)LPchOIkTQP(M`TZc6jE{_iyE{`qug=1rUN&5%+xK_E#ce4j
zC`c}^a>m;iVpzOEITWYDJxR82;4PCb6Jg(uFZ8@xkieEYe6~
zA7|pVw>;^g)B}f4rT^YE+6yE4z6-I2KA{$eX@bZ_1lmdg4AZ()tY72jM@BX7mCj-f
zfc}H=zworw4%It`VV%TOVo$15RBmemglItON&-2Z@SS0M5=71P;>R6h;s9*OOG`)#ssVK3S}-
z@6tJ_8q*B6VqJ;8UMT{fgG4~=qp3u7I8DH^rSQJ*M?|q*(8(eng1j-i{8`7(pAynS
zvbT)_V1lA%WAYkkShDCT6*gs5RT8(BMN
zJ9-N(T2Rf(=s@6q^>1*;xBZhdTaLz0)}E&iOf4Q`yiG$&OL!+=BPTisNbD_Dt@kFr
zz820zGX1T@{+nt_4RX?#RyPGiVNOw09?W*L;ps%?-h+N}3EgiJ5)OO*d;fr`nA5jY
z)3n{c{e6Os6cqK+09zJ}xA$-Au#)4CtkdN+A1y!v4<7FK(mb)bZ_ycW_^;^yeRiA<
zA)*0vi|F@vl|f^$njy{C&SdOXvf`ak18`rSWEb-^ZQp7VsUG>0Qc2ePR~)j$3nCHNV01
zJoAlpIyuO26UDDeif=UR7N4WD9#`fXD;R68qK|YnrV@#s>_*_Exd&-8JmvXom_aTXNT?it~9?CEeh734c~%|(L=mr7whN7AEOeJOie_a
zFCZoYPUaSoyx7`Xg-tjdG@TtkEFVun=q0K%CTMQ)%mY<9@VKKFLh27uD)VTD`%*u3
z6e9L#>d79=K{8fuPgNI)33pTD*Ah_1Nbis9+um{MThTUgULwJ`Wn12fCLg|`b3=lo
z6!#+8HcNPNih=W%t3sk>JmMTs(uR#W9|73kuTedJ^b%tGWLw=MXWA-m_D}j^z@jpK
z)6Ua~@AvU3th0Nvcz%fRJiJ&c|7FMzp|wZd+}yw!b8lI7*VQA|$toJQatsefkFW5}
zp$ZipKb+IunD%I@CC&;q1Upd)#d8M$cQwYCX@>|pO?4?%DH?2
zIk4hMLU66Aj^*HDJUdjUoP0Z<|E->FxwLV7mS{5kPMuC1dR5O9-KF=?PqRs%A~I0?
zz|kH%K~qb<_$BG0Khi*&Vf-d$AgpriqT+HwGQbAg_*7u@$^#Q2TT;(PDTwVb?+^<*
zG-|z;3Q-PcU+)j^ZA04P1rUmjDi>MGY_dOkTW5U!vJ)GFHWLd5Ld9k~gmvr-abo-JSw
zqXJx1dgztRqwx;-$jZU@|4S|lX-VguPAbjX<`iQ3&hGo%&xpdzvjYB-GyntQgx8}YNT<$dG
z#WGM)+{+oft6p+r+;ne
ztyf@-R+lvYcByiR)6$@QVi+pX{GHfG7W|78Zuh&X{)Jt}#mm$aX47|OAFrt%T$cC?
z7za;hVW(}^cRuh;eTW#qjk^1i#UDNTCyyOgw0UCD?u;o(U
zTD47;LeWXptaz0|Tyjq;V4C@trytdO8~(tTO_Gs)&`
z62ccmF9Ph5txN7B(4TLAqJV?*o-B
z1O7dQ@)Vl0#*8Q1E3J(JU3pLhpcN}^HG7oR2sX0H}(OEH-27cB>w5XwE4h8
zRPL`IBrCJ;+iV*b`b|CGBm~F!@?PaWf1;3_pnfKaR5RlHpCA5!=WqHw%~?ge+HHb(
z)=3d!OVHmwhqgz#fAP2hTxAc9w8te_#yuUnJpAayf
zwb;phhpP^meGeH$u3TV`lTZ}*^j{BQ2*T5hcO52N=`eE<)J
zux@!{QhC#z>wm9;9UIN>DTpO+kia^@`;gDTriG>SqmhZk`o1*<{Rguq$qD@dSW0y7
zvv)^kYPW?^_KRWpi^~--*n%Q945oCXAaaF0mO9e0)4=S(_#=Vy4Y_o~B3oAIQ@^O9
zStO7=y49Mm_qrL!#Ji#vx53NaG=X4V5RAVbc+8Ly_W5H4H_N*B%^OTR9yfm;mF2Hl
zIXK|LEwSyZcKVyD*5;i?gA`&Hb>X}6xf;9v8dE$!roSO@E-Jc`pCOe(e
z?uDq@%-P*2_X6Q&GQ5n-1IaHwo5c8C4hQe#hfFqG;y^ddQ%T2OCn{^vs{|@=_S8+g
zK2+POa5_FAm54xJocd^uIiX)CXCi0avI$yFuzR&EX
zVUte|yQu%CR;yW)z1TLS^6vQzYs8~<32SBzvP?|KQv1wf@R7p^mF$pO(2ZJmq(Q;G
z(9|D#MFghn=*d=QcQpMx?GGkIi4!iyZo4-@5v_&=fA@mtP&_Dcg+(t&Sp?9M$D9n#
z5gqNs`8WQUob$nA!WF|3`%P*DD*wZI^W>ACumvcUsZQ*v<5%=&D6c-ACamjBYJ8>Y
z#2=_D_iM>)EOYyDU+j@ay0(*<{K4v^W%4nj)rS%er(SD}Ci)8h6AeH7v;V8ZiQ>->US0`qT4?O5hxmsvgkA8XbrJlKidf+syji9O}lyZ$yriRkQc
z9dy-0l3m_Q`QoMZdDRv6+{LqRDlc~|(^;H)kQ%d(fkWRgVH>ci7B$+@w2GrJ20ON8
z`c*itcIN4pdR#L$R~k0!N{F>0>n2W6VYv94f77jdrt+rLDcz0sui)zen^+Fa8EwjT
z@I4!u25m6O-~c<>$vj6)cUZm9#D2>XwhH5Fy7867b-kET(!BNiaYqsliic(W`umNC
z_D#M1M7Zq4Qrrkv$-Rs
z-2NvyA?5-ji~X?vGJeVU3Z-THn;YrJ@SbBG#7|EAb0HakJtGOE@}DyARrq3*Ej
zmX)YahG!rD-5@zgH6_$9gr$n7Apa<0w{1NAPldH%w1!D>@y^=axqoR1>WSnb$|r73
znXTtMVqTW}HjkV*5{>4)hF6h!l{??6;b~EH;)+I<4QQ}VR-QIAJ0+K-m>?k<~SJ!ZZ2es
z5=foTr@iD=g;)&c-`$&p&_r!eGe7l^gpVxa&5&4tHDJ9HRTwdc=l@tUX$Dl+v(w=1
zR@XrTE5vq)u}K>EuX&JX<5$Oa30_x^^y;9WaL|x#^=`R5T-@8}+=kQ^lrj8u4HKvG
zdeVU|#-CG6TZkTJDfO?_lwhbu?G2LZ8EQX|JGv?n9V!m0b$$LkZOfZ9^H`mMn-3}b
zm_>(j02@dwV{`t8G*SW~mum#N-LsYs^N1d~4QgpW8K>mB649H};V*!|#cy>0tkpar
zS>5Vx3M5BX*ls~bMO7H~CD$!OQdM>FIYnAAB*!nn1ZB#aoC)vBjw&u@cfi{yy-6-J
z5jh6+X(RREPBcnDH_2HsOr?&Mqd)iMo<94{OoHY+yW0R1zvI&q%uu40`a^n4n6ULJ
z+f&@VPC0ot^)9yfxz6qh$=7d{6=B!qw^4buE9vPu*otxn4(kWw;<<)bJv;_r@Vg5R
zyuNt*MmD*rEcY*hdJC8|D`EcS2@e$srk{p*&uU0GKaZ7&KS+(T4s}4P?xqA6PbK`%DI2ACOQ@*8gz+S1u#_^b7EBNsaq$VXQ#5Q#gyjy|{W5DdL
z^i=mds*Iz$bSI3dJ>XBa2~U$~XUiCFqQR--swFw9W+yJZ9ZMb6eB0Fyi@M>c&?=M
zP!^~tC>qR0`*R?ZEGClf?F^YO7kvs-k`?Bue}7f`CtmZFCUd#9=2YC2bsp2NMccbo
zh87BEwGHY^9vk9VSB!TC>w3}^H2{qoX+%1fUxGgUA^9OZ?ep_!D^H
zM+aFwm%(7CWy{*UZS)tcusZtbA=MAGneN|H?joXby*E)PT3$dXE0irMyx@EK)vKJj
zTHOWHxq);SU^-=O*}gisS>D{ZX%gS1y}zz4*5s(6U;L{2Es<>hgSwt|G3OWa
zU@w_7E$eXo{{Y4M-=8B_$kcxq1B9tB9Z6^PE_4|SIG>w}uq~olkdnjU!3K`6jt_18
z&lJPZO$eYERIyBxt4}w3Jx#%D==DwK-s=zJ-o>*mijw=xL
zp9Xgf=y8sxLMXww5|lJh!pDkB4#FKsrr13lkz6xaY&p!G+vDgjH>F&c+%X-<-k%-p
zR>-Dkfol@0G0{DZ>UaMAZ`Xte6^>;UB%(D*!{BpEeiG1nK`c(xgGxJPuEs@J)(FIB
z163Vac$2yOn&})F5WdK)O2y0WpE5Y1BGCwuO-Q09_sWkN@MU`Ow%q6y5(t**
z9qyZX$Ch^0r1?(?+Gi#DmLn=aj2`bKBoeL|hc*N}f3Tf3q+hW9>CQbU#jC7(NR`5w
zVCIv}1swxvJ=p;5aDJ9=Pj$+tJDDtXPKl`O0(=!5epKplEK2R)$1q@Wk(49-IBgU)
z;CBYmN`r*HELuUs)+6&(MLlnseS{U`M=#4xRsPt3rVMDOJ2Bf&(j*0pb@tTV4-)AZ
z|86Y2mt`@V{iUG6dJ>2mFd_v79GDZseNl0&gSyaZ7oY@%5i4H5cr;aC^n1Ao`n@A2
z;8ND|PE%C-$VEoDZcy1^Q|0C9a1dSjZgoD+<2Vb<&7-pbiKGfuw@`r$_fspSnLde?
zDJ*a1n@R6|X2~<`e{97T<|xe{TZ5$y^acgjPx$37ab8O}~IvUgEp64t`Ke?SJc2WF1`1V^%3^=!#~9VREcp)uk?k^QE^GcF2p-b>mKTP@dH!l>*I
zZfBV#a2eg81d_1Lnh6YR%ochDtf07GXzdY)#+Ub>Gg;TFxq7C?N9%EiGpMs)3+3C}
zG%|fnTlyf`xvB;AwfR+X#@K?>URO88R9MBYL4wCFnCvy;YF3{f7XrKIbeP2Q$k<)I
zWUfa^ReLp^_8KZ8p>d41o-A5@$0Z`Tocb@Ka{RNon)X_;eSz&hmtmV;z3+Te7XEZP
zv^u@K`{Dg^D6J-|DSI
zlT_NEgpGpzoIj)ceQ{A+ONbcTe1+tXlpQ)I*NRdV;xPrm&5Hp|B{Qyhvp=oqh~pr|
zpAn__czALaz`>1rpa?xMIE8i+RS1}|-Z!>l<*=r@oFDU`J|lYp5n@$-6X2}AvM3?2
zh74Q}e4ko@w6_2kp7dRR7Q}COPn>}Ux#Nf)0|^P=VpsBrHpn$=gR^TAD@f*El6Ewb
zt-WyjSSC?PIudmqFoC@PKIzojW-8(FziV0#2PXPXoHmpi(346;i@B9iA$y=J00thU5;tal8S$o$prR{W|FkQXe-BnXeHVOeJT
zyd!l&gh+4jAAUywEqLOHyijzgQ>5dc@IJqkzCm+R-~D@@#75rqreoHlPfH&~-T$t@
zu?9%@Gk-e1*ZlIo{qrbkU#t)|2}2>+2^SPwPl|Nj5_Ng~7IkPYHC5x*nu8G$&2o6)
zr{S3Y2O3M=Cu_1T999I6WzzrsHO7S*a-Z&Akc+K87-NM=M=?#u
zSa=OmRi3^uNrrKwfoU3#2c%o3p707z^FY5tE59FEijn*pyqCaO*z#5d&ZqZIHU6KW
z(oqq|{o>v^S305Z=7OMOZerDx+3RJ&bw_n}-9I`B+7Oy=`d~vfm{0z3yKj#<|JxT;
zrv&^E39bb?2
zhpXRNLamiP4HEeY&uPJ?7rXW`Wr(i@tTnEa&yJU!
z=ZfnfYRl2?J?&nSt~8j-+4T`IIcE7}U`KXRQc0jv-u-;dSjQfhR?%{7oxU42Ieko0
z|FY&og7fqW)k=I~psLo(Fnn)GlfN0Gd9vk6>0wr^9MK?5;mVRMCWZ0Wu(ER|EHpT{UW$DPcC+sg8cJoBcy@Y
z$?VpG@#@4o_
z6=7DQyyl%EC8TF=Q{U`SE5p_b
zWF^%ufXeO0LiFlZ@vK2K!U+cF0S{7=)Bn@_s+&;g=a9DpF4F6`UPBGj(4vSEx*4W#JGpS;+5kDj=>Mni|a_`kZOB&f4|BFfdkH~kF6JhMzWm88AUl#W+p#2;|-BSl@wzL$XVD11=-?1yn9
zC8^W1)Or>Y*K#98F(Bx*x1c~wXbaWn*kZ?9zplobr2K!_eKvYJLY$UMI3NsYOlJT~
zzA+_v*rtBQ#SIG%Mtfm{%C%ToEjSoz#%wc60qIHkxgcOUnR;!pai&{swYLtbj73DN
z-uB&j7H!(p!C>c~f;wl?_j-efqo{ZIw6U(560lE1=EyuPqX3Jq@imjNqxtqoB~L;z
zRF>zv3-Cscg!~YzZGcfh{TuJT+|x?yHsw8Fl@FP;#gUT};GJ2l$S!_y;oF}G01S0a
KbsDq~vHu5dlQb9r
literal 0
HcmV?d00001
diff --git a/themes/hugo-book/.github/workflows/main.yml b/themes/hugo-book/.github/workflows/main.yml
new file mode 100644
index 0000000..9ae4f54
--- /dev/null
+++ b/themes/hugo-book/.github/workflows/main.yml
@@ -0,0 +1,24 @@
+name: Build with Hugo
+
+on: [push, pull_request]
+
+jobs:
+ build:
+ runs-on: ubuntu-latest
+ strategy:
+ matrix:
+ hugo-version:
+ - 'latest'
+ - '0.79.0'
+ steps:
+ - uses: actions/checkout@v2
+
+ - name: Setup Hugo
+ uses: peaceiris/actions-hugo@v2
+ with:
+ hugo-version: ${{ matrix.hugo-version }}
+ extended: true
+
+ - name: Run Hugo
+ working-directory: exampleSite
+ run: hugo --themesDir ../..
diff --git a/themes/hugo-book/.gitignore b/themes/hugo-book/.gitignore
new file mode 100644
index 0000000..5944200
--- /dev/null
+++ b/themes/hugo-book/.gitignore
@@ -0,0 +1,4 @@
+public/
+exampleSite/public/
+.DS_Store
+.hugo_build.lock
diff --git a/themes/hugo-book/LICENSE b/themes/hugo-book/LICENSE
new file mode 100644
index 0000000..e7a669a
--- /dev/null
+++ b/themes/hugo-book/LICENSE
@@ -0,0 +1,20 @@
+The MIT License (MIT)
+
+Copyright (c) 2018 Alex Shpak
+
+Permission is hereby granted, free of charge, to any person obtaining a copy of
+this software and associated documentation files (the "Software"), to deal in
+the Software without restriction, including without limitation the rights to
+use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of
+the Software, and to permit persons to whom the Software is furnished to do so,
+subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS
+FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR
+COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER
+IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN
+CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
diff --git a/themes/hugo-book/README.md b/themes/hugo-book/README.md
new file mode 100644
index 0000000..89b6719
--- /dev/null
+++ b/themes/hugo-book/README.md
@@ -0,0 +1,358 @@
+# Hugo Book Theme
+
+[![Hugo](https://img.shields.io/badge/hugo-0.79-blue.svg)](https://gohugo.io)
+[![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](LICENSE)
+![Build with Hugo](https://github.com/alex-shpak/hugo-book/workflows/Build%20with%20Hugo/badge.svg)
+
+### [Hugo](https://gohugo.io) documentation theme as simple as plain book
+
+![Screenshot](https://github.com/alex-shpak/hugo-book/blob/master/images/screenshot.png)
+
+- [Features](#features)
+- [Requirements](#requirements)
+- [Installation](#installation)
+- [Menu](#menu)
+- [Blog](#blog)
+- [Configuration](#configuration)
+- [Shortcodes](#shortcodes)
+- [Versioning](#versioning)
+- [Contributing](#contributing)
+
+## Features
+
+- Clean simple design
+- Light and Mobile-Friendly
+- Multi-language support
+- Customisable
+- Zero initial configuration
+- Handy shortcodes
+- Comments support
+- Simple blog and taxonomy
+- Primary features work without JavaScript
+- Dark Mode
+
+## Requirements
+
+- Hugo 0.79 or higher
+- Hugo extended version, read more [here](https://gohugo.io/news/0.48-relnotes/)
+
+## Installation
+
+### Install as git submodule
+Navigate to your hugo project root and run:
+
+```
+git submodule add https://github.com/alex-shpak/hugo-book themes/hugo-book
+```
+
+Then run hugo (or set `theme = "hugo-book"`/`theme: hugo-book` in configuration file)
+
+```
+hugo server --minify --theme hugo-book
+```
+
+### Install as hugo module
+
+You can also add this theme as a Hugo module instead of a git submodule.
+
+Start with initializing hugo modules, if not done yet:
+```
+hugo mod init github.com/repo/path
+```
+
+Navigate to your hugo project root and add [module] section to your `config.toml`:
+
+```toml
+[module]
+[[module.imports]]
+path = 'github.com/alex-shpak/hugo-book'
+```
+
+Then, to load/update the theme module and run hugo:
+
+```sh
+hugo mod get -u
+hugo server --minify
+```
+
+### Creating site from scratch
+
+Below is an example on how to create a new site from scratch:
+
+```sh
+hugo new site mydocs; cd mydocs
+git init
+git submodule add https://github.com/alex-shpak/hugo-book themes/hugo-book
+cp -R themes/hugo-book/exampleSite/content .
+```
+
+```sh
+hugo server --minify --theme hugo-book
+```
+
+## Menu
+
+### File tree menu (default)
+
+By default, the theme will render pages from the `content/docs` section as a menu in a tree structure.
+You can set `title` and `weight` in the front matter of pages to adjust the order and titles in the menu.
+
+### Leaf bundle menu (Deprecated, to be removed in June 2022)
+
+You can also use leaf bundle and the content of its `index.md` file as menu.
+Given you have the following file structure:
+
+```
+├── content
+│ ├── docs
+│ │ ├── page-one.md
+│ │ └── page-two.md
+│ └── posts
+│ ├── post-one.md
+│ └── post-two.md
+```
+
+Create a file `content/menu/index.md` with the content:
+
+```md
++++
+headless = true
++++
+
+- [Book Example]({{< relref "/docs/" >}})
+ - [Page One]({{< relref "/docs/page-one" >}})
+ - [Page Two]({{< relref "/docs/page-two" >}})
+- [Blog]({{< relref "/posts" >}})
+```
+
+And Enable it by setting `BookMenuBundle: /menu` in Site configuration.
+
+- [Example menu](https://github.com/alex-shpak/hugo-book/blob/master/exampleSite/content.en/menu/index.md)
+- [Example config file](https://github.com/alex-shpak/hugo-book/blob/master/exampleSite/config.yaml)
+- [Leaf bundles](https://gohugo.io/content-management/page-bundles/)
+
+## Blog
+
+A simple blog is supported in the section `posts`.
+A blog is not the primary usecase of this theme, so it has only minimal features.
+
+## Configuration
+
+### Site Configuration
+
+There are a few configuration options that you can add to your `config.toml` file.
+You can also see the `yaml` example [here](https://github.com/alex-shpak/hugo-book/blob/master/exampleSite/config.yaml).
+
+```toml
+# (Optional) Set Google Analytics if you use it to track your website.
+# Always put it on the top of the configuration file, otherwise it won't work
+googleAnalytics = "UA-XXXXXXXXX-X"
+
+# (Optional) If you provide a Disqus shortname, comments will be enabled on
+# all pages.
+disqusShortname = "my-site"
+
+# (Optional) Set this to true if you use capital letters in file names
+disablePathToLower = true
+
+# (Optional) Set this to true to enable 'Last Modified by' date and git author
+# information on 'doc' type pages.
+enableGitInfo = true
+
+# (Optional) Theme is intended for documentation use, therefore it doesn't render taxonomy.
+# You can remove related files with config below
+disableKinds = ['taxonomy', 'taxonomyTerm']
+
+[params]
+ # (Optional, default light) Sets color theme: light, dark or auto.
+ # Theme 'auto' switches between dark and light modes based on browser/os preferences
+ BookTheme = 'light'
+
+ # (Optional, default true) Controls table of contents visibility on right side of pages.
+ # Start and end levels can be controlled with markup.tableOfContents setting.
+ # You can also specify this parameter per page in front matter.
+ BookToC = true
+
+ # (Optional, default none) Set the path to a logo for the book. If the logo is
+ # /static/logo.png then the path would be 'logo.png'
+ BookLogo = 'logo.png'
+
+ # (Optional, default none) Set leaf bundle to render as side menu
+ # When not specified file structure and weights will be used
+ # Deprecated, to be removed in June 2022
+ BookMenuBundle = '/menu'
+
+ # (Optional, default docs) Specify section of content to render as menu
+ # You can also set value to "*" to render all sections to menu
+ BookSection = 'docs'
+
+ # Set source repository location.
+ # Used for 'Last Modified' and 'Edit this page' links.
+ BookRepo = 'https://github.com/alex-shpak/hugo-book'
+
+ # Specifies commit portion of the link to the page's last modified commit hash for 'doc' page
+ # type.
+ # Required if 'BookRepo' param is set.
+ # Value used to construct a URL consisting of BookRepo/BookCommitPath/
+ # Github uses 'commit', Bitbucket uses 'commits'
+ BookCommitPath = 'commit'
+
+ # Enable 'Edit this page' links for 'doc' page type.
+ # Disabled by default. Uncomment to enable. Requires 'BookRepo' param.
+ # Path must point to the site directory.
+ BookEditPath = 'edit/master/exampleSite'
+
+ # (Optional, default January 2, 2006) Configure the date format used on the pages
+ # - In git information
+ # - In blog posts
+ BookDateFormat = 'Jan 2, 2006'
+
+ # (Optional, default true) Enables search function with flexsearch,
+ # Index is built on fly, therefore it might slowdown your website.
+ # Configuration for indexing can be adjusted in i18n folder per language.
+ BookSearch = true
+
+ # (Optional, default true) Enables comments template on pages
+ # By default partials/docs/comments.html includes Disqus template
+ # See https://gohugo.io/content-management/comments/#configure-disqus
+ # Can be overwritten by same param in page frontmatter
+ BookComments = true
+
+ # /!\ This is an experimental feature, might be removed or changed at any time
+ # (Optional, experimental, default false) Enables portable links and link checks in markdown pages.
+ # Portable links meant to work with text editors and let you write markdown without {{< relref >}} shortcode
+ # Theme will print warning if page referenced in markdown does not exists.
+ BookPortableLinks = true
+
+ # /!\ This is an experimental feature, might be removed or changed at any time
+ # (Optional, experimental, default false) Enables service worker that caches visited pages and resources for offline use.
+ BookServiceWorker = true
+```
+
+### Multi-Language Support
+
+Theme supports Hugo's [multilingual mode](https://gohugo.io/content-management/multilingual/), just follow configuration guide there. You can also tweak search indexing configuration per language in `i18n` folder.
+
+### Page Configuration
+
+You can specify additional params in the front matter of individual pages:
+
+```toml
+# Set type to 'docs' if you want to render page outside of configured section or if you render section other than 'docs'
+type = 'docs'
+
+# Set page weight to re-arrange items in file-tree menu (if BookMenuBundle not set)
+weight = 10
+
+# (Optional) Set to 'true' to mark page as flat section in file-tree menu (if BookMenuBundle not set)
+bookFlatSection = false
+
+# (Optional) Set to hide nested sections or pages at that level. Works only with file-tree menu mode
+bookCollapseSection = true
+
+# (Optional) Set true to hide page or section from side menu (if BookMenuBundle not set)
+bookHidden = false
+
+# (Optional) Set 'false' to hide ToC from page
+bookToC = true
+
+# (Optional) If you have enabled BookComments for the site, you can disable it for specific pages.
+bookComments = true
+
+# (Optional) Set to 'false' to exclude page from search index.
+bookSearchExclude = true
+
+# (Optional) Set explicit href attribute for this page in a menu (if BookMenuBundle not set)
+bookHref = ''
+```
+
+### Partials
+
+There are layout partials available for you to easily override components of the theme in `layouts/partials/`.
+
+In addition to this, there are several empty partials you can override to easily add/inject code.
+
+| Empty Partial | Placement |
+| -------------------------------------------------- | ------------------------------------------- |
+| `layouts/partials/docs/inject/head.html` | Before closing `` tag |
+| `layouts/partials/docs/inject/body.html` | Before closing `` tag |
+| `layouts/partials/docs/inject/footer.html` | After page footer content |
+| `layouts/partials/docs/inject/menu-before.html` | At the beginning of `