Hello,

i made a fork and tried it. I think I found a little bug. I attached the pictures. Appears on start page and page 404 only.

I think the bug to include search.html twice in the home layout. If I toggle line comment, it works fine.

Tamas

Appreciate your good job..
wondering how to disaplay TOC of post on right side?

If I jump to a page and query the information of this page, click the link, it will suddenly jump, and then immediately jump back to the query page, I don't know if it is my certain configuration problem

1. Can the search box support Chinese search?

2. If the markdown file contains syntax highlighting, it will be difficult to distinguish the background color from some code color when night mode is turned on.

• e.g. [ & ] in if [ -n "$a" ]

_{Sent from PPHub}

Thank you so much for addressing the formatting that led me to this! 🙏 Here is yet another strange mobile webkit-exclusive thing that I randomly discovered when viewing the theme in Safari. With side menu open the header is interpreted as a horizontally scrollable field allowing for a little bit of wobble.

I apologize for keeping reporting such petty things.

Hi! I'm loving the theme and want to use it for a book-style website, but I ran into one(-ish) weirdness. The desktop version is borderline perfect, but I have a few questions regarding the header buttons' behavior in mobile mode. I understand why this happens, and that this is completely tied to the width of the window (it only happens in portrait mode), but I lack brains to solve it myself.

Can these buttons become hidden on mobile when the left-side menu is open?

With menu open they don't have much functionality in portrait mode anyway, because of things like this:

A whole other part of the problem is that the buttons become glued to the top of the window, along with the menu button, so you can't close the menu unless you scroll all the way up or tap on a chapter (this also happens on desktop if the window is made very narrow):
https://user-images.githubusercontent.com/60663493/207224503-b4014dc2-d33a-44cd-97d5-53e4cd5b2a08.mp4

Can the menu button (or all of them, for that matter) be unglued from the top in mobile/narrow window with the menu open (when the header collapses and the buttons align vertically)?

Sorry for rolling two issues into one, but I recognize that these can be considered extremely pedantic non-problems, so please consider this posting a question rather than a bug report.

wish this will support tags and latex syntax

I changed the post of 2019-04-28 to 2022-08-14, but it seems to have disappeared. I have tried to reload the site several times, but no posts have been returned. I checked that the date is set as a variable in the code, what's the problem? The same goes for all the other posts.

There's no Gemfile in this theme's repo. How does one setup this theme into a jekyll site?

Hi, why is the date needed as part of the post name? How can I disable that option in the theme

e.g.

2023-05-24-example.md - is published on gh-page

01-first-chapter.md - isn't published on gh-page

Any suggestion that I can follow to add custom fonts?

gitbook allows for cover images.. would be great to see support for that here, thanks!

example:

Will be great to add info about the social media icons. I did a microsite and I want to personalize the facebook and twitter but I only found references to facebook in the plugin code and I could modify them but clearly not a proper solution.

Probably good idea to do it via data using yaml to be capable to customize enable or disable those icons.

The README instructions indicate to use the theme we have to fork the repo.

GitHub pages also provide the positivily to throw a bunch of markdown files and a _config.yml file into a docs folder.
I tried that in this repo but it doesn't seem to work well? microbit-carlos/microbit-bird-activity@76ee1b5
It fails to load these assets:

Loading failed for the <script> with source “https://microbit-carlos.github.io/microbit-bird-activity/gitbook/gitbook.js”. [microbit-bird-activity:222:1](https://microbit-carlos.github.io/microbit-bird-activity/)
Loading failed for the <script> with source “https://microbit-carlos.github.io/microbit-bird-activity/gitbook/theme.js”. [microbit-bird-activity:223:1](https://microbit-carlos.github.io/microbit-bird-activity/)
Loading failed for the <script> with source “https://microbit-carlos.github.io/microbit-bird-activity/gitbook/gitbook-plugin-fontsettings/fontsettings.js”. [microbit-bird-activity:225:1](https://microbit-carlos.github.io/microbit-bird-activity/)
Loading failed for the <script> with source “https://microbit-carlos.github.io/microbit-bird-activity/gitbook/gitbook-plugin-sharing/buttons.js”. [microbit-bird-activity:226:1](https://microbit-carlos.github.io/microbit-bird-activity/)
Loading failed for the <script> with source “https://microbit-carlos.github.io/microbit-bird-activity/gitbook/gitbook-plugin-search-pro/jquery.mark.min.js”. [microbit-bird-activity:233:1](https://microbit-carlos.github.io/microbit-bird-activity/)
Loading failed for the <script> with source “https://microbit-carlos.github.io/microbit-bird-activity/gitbook/gitbook-plugin-search-pro/search.js”. [microbit-bird-activity:234:1](https://microbit-carlos.github.io/microbit-bird-activity/)
Loading failed for the <script> with source “https://microbit-carlos.github.io/microbit-bird-activity/gitbook/gitbook-plugin-back-to-top-button/plugin.js”.

Is this method of using the theme supported?

I want to change the share links in the top right corner to my GitHub repository address and telegram group address.

A separate _includes/gitbook-sharing.json.tpl has been added to tweak the gitbook sharing plugin configuration. You could update the "github" and "github_link" entries for github, and "telegram" and "telegram_link" for telegram, respectively.

(You can has a customized _includes/gitbook-sharing.json.tpl under your own project root directory to overwrite the default configuration.)

I tried, but it failed. Would you check for me?

It looks like something went wrong.

Originally posted by @Oreomeow in #45 (comment)

I'd like to insert code into my details html tag :

But the theme does not interpret the code snippet into my detail tag.

Any idea ?

The theme currently uses a custom.css (in assests/gitbook/) for special local settings.

However if people use the theme in a jekyll-remote-theme setting this obliges them to copy and extend the file in order to add own extra entries.

i would like to suggest

• introduce an extra custom-local.css that is just empty (apart from a comment declaring its intent)
• that is imported at the end of custom.css
• that can then safely be filled in locally to add extra useful style rules...

if you like this idea, I will gladly work up the PR

See here : https://zenmoore.github.io/note/2021-08-13-notenlppretrainedhit.html
When I click the toc, "I.任务层级" for example, it cannot jump into the right place.
In fact, it doesn't act at all. T_T
How to deal with it ?

我是小白，实在不懂，求大佬解答

I noticed that when I want to go to a h1—h4 title, the navigation bar closes instead of going to the desired section.

This only happens on titles within the same ".md" document, if I want to go to another document it works perfectly.

Thanks for adding the search plugin!
Would it be possible to add a quick return to top button? When an article is too long, I add a table of contents with jumpable links at the top and when I get very far down the article, I would like to be able to quickly return to the top table of contents.

I want to know why css styles are not working.

I am absolutely in love with this theme and super grateful for its existence, and maybe I just care too much about inconsequential stuff, but I have discovered yet another strange "problem" on mobile. It seems that in Chromium-based mobile browsers gitbook pages have a tendency to load slightly pre-scrolled (initially discovered in Safari on gf's iphone and then confirmed in Chrome on both iOS and Android). Only happens on a fresh load or a page refresh: if you go to a different page via the side menu, it will open properly, and all the other pages of the website from that point on will load as expected too, but if you then refresh the page, it will load slightly pre-scrolled again. I tried tinkering with parts of the code that mention webkit, but couldn't identify the root of this behavior.

Hello, I'm new to Jekyll! Your theme is awesome.

I wanted to know if it is possible to remove the "Fork It Now" on the sidebar while using a remote theme.

Thanks.

Hello there!
I have a question hoping for help! Any pointers are immensely appreciated! Thank you very much!
The footnotes on my page refuse to go to the appropriate place at the bottom of the page. I really cannot figure out what is preventing it so. https://offingbloom.com/ob-v1/2023-07-16-prologue.html
The footnote appears to be written correctly as such:
Tanhua1
But it doesn't scroll on the website. I am not quite sure this is.

Thank you kindly for your time!

No effect on book-summary and book-header with the custom fonts settings here:
https://github.com/sighingnow/jekyll-gitbook#customizing-font-settings

Need to edit /gitbook/style.css:

.book-summary {
    font-family: "CustomFonts";

The same for the book-header, add:

.book-header {
    font-family: "CustomFonts";
}

I have added several md files under the _pages folder with names 01, 02, 03, but the order of the directories displayed on the generated webpage is not 123, but 321 in reverse order, how do I change it? Can they be sorted numerically from smallest to largest?

simple test data

|title1|title2|title3|title4|title5|title6|title7|title8|
|:-:|:-:|:-:|:-:|:-:|:-:|:-:|:-:|
|1|2|3|4|5|6|7|8|
|1|2|3|4|5|6|7|8|
|1|2|3|4|5|6|7|8|
|1|2|3|4|5|6|7|8|

and there is no scrollbars for the viewer

update

got an alternative solution to show a scrollbar when writting MD
https://stackoverflow.com/questions/41076390/is-there-a-way-to-overflow-a-markdown-table-using-html

<div class="table-wrapper" markdown="block">
*TABLE CONTENT*
</div>

css add:

.table-wrapper {
  overflow-x: scroll;
}

手机端点击Click to Search,显示404,page not found

Would it be possible to have tips, warnings, and danger messages, like in gitbook?

Thank you for contributing this excellent theme. I really like it. I guess it could support the search function using lunr. But I am not familiar with the code. Would you mind share your opinion about how to make the search function work within this theme? Thank you!

Is it possible to add topic categories? Click on a topic in the left navigation bar to expand the post title.
e.g. https://lawbook.cf
chapter-fold plugin

_{Sent from PPHub}

In remote_theme mode

• I want to change the share links in the top right corner to my GitHub repository address and telegram group address.
• I want to modify the favicon.ico.

Is this feasible? I look forward to your reply.

Sorry if this is a stupid question, but I can't find a way to apply a dark theme. Is there one?

Is it possible to freeze the position of panel book-header so that page scrolling doesn't affect it?

For articles the button back-to-top is suitable, but not for documentation. In addition active partition is highlighted in the menu.

Thanks for the minimalistic template!

Thank you for making this theme. I love it. thank you.

Well ... I wanna use Google Analytics option in this theme.
If you don't mind, Would I ask about how to use the Google Analytics option?

There is something wrong when it comes to math formula processing !
see here : https://zenmoore.github.io/theory/2021-09-21-structuralentropygraph.html
I have no idea why it happens and how can I deal with it ?
source codes : https://github.com/ZenMoore/zenmoore.github.io

Hi. I did Fork your project and set it up as a source on Github Pages, but CSS styles do not work and links to other pages are referenced incorrectly.

You can watch it on
https://igorhoop.github.io/hoop_docs/

Sorry for stupid question, I haven't fully studied Jekyll yet

Thanks for your work.
Do you have any plans to support rendering for mermaid?

Describe

I had multi-level directories, as follow:

_posts
├── 2023-08-01-labelimg_to_yolov5.md
├── test-demo1
│   └── 2023-09-01-test1.md
└── test-demo2
    └── 2023-09-01-test2.md

When I used the jekyll-gitbook, the sidebar only displays test1 and test2, as like:

Expectation

Bug report

First thanks for sharing this great theme 👍

Problem definition

The < and > buttons in the left and right side of the page drive the reader in the reverse order for pages.

How to reproduce

1. Go to the first page in the menu for the demo site here
2. Notice it will only show the arrow for the "Previous page" while this is the first page
3. Go to any other page in the menu and use the "Previous/Next page" arrows, Next link to the Prev page in the menu

Expected

Starting in the main page using next will move to the next item in the left menu, first pages then posts.

Notes

It works OK for posts.

change page from sidebar doesn't render mermaid, need refresh whole page which cause mermaid to show.

as a side effect of looking to #73 I noticed that he drop down menus (on the left for font + background, on the right for sharing) do not work if the summary-side bar is active.

I see the style-effects are still correctly applied (the .open class is added to the correct div.dropdown) but somehow that does not make the menus actually pop up.

I assume (for now) there is a conflict between the book.with-summary leading to left: 0 applied on a higher level. Would need more investigation, but wanted to share already in case somebody has a quicker eye on this.

Hello there, how can I add a page (searchable or linkable in site) that doesn't show up on the Toc? I tried to add a page as a link to the bottom of the toc footer using the post/home layouts, but they would show up was 404. If I need to make a new layout for these pages,how can I do this, and where do I change on the new layout html? Thank you so much for your time and help!

thank you all guys for this great theme. I like it very much. It's very clean.

but I'd like to have a comments function for this theme, I also searched for gitalk for comments.
Do you know how to integrate with this theme?

After 0cbb5a2 #18
However it won't jump when you click on the left sub toc (e.g. why this repo) on mobile. I recommend this plugin repository: gitbook-plugin-anchor-navigation-ex for both top return and quick positioning. And it is not affected by page scrolling.

Hello,

if there is not enough content.

Tamas

Hello, just need some help after successfully deploy this blog on my account.
I want to add two more category like cpp and python, how should I modify the code?

How to make the content page more wider