-
-
Notifications
You must be signed in to change notification settings - Fork 297
Add support for displaying TOC on the side of page #398
New issue
Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.
By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.
Already on GitHub? Sign in to your account
base: main
Are you sure you want to change the base?
Conversation
You are my Goddddd! |
我按照你的来不知道为什么不生效,请问是否有一个可以参考的操作文档呢 |
@Coder-itCheng 我没看到你博客的仓库,所以我也不清楚你怎么改的。可以参考更新 MemE 的方法,不过要把 clone 的仓库链接换成我 fork 的仓库: rm -rf themes/meme
git clone --depth 1 https://github.com/koktlzz/hugo-theme-meme.git themes/meme 最后在 注意这样做的话你之前魔改过的配置就没了,可以先 |
本來也想照這個改,但發現這項改動在手機版會出現重疊的情況,不利於手機版閱讀。 |
这个问题我也考虑过,目前的解决方案是屏幕宽度小于 @media screen and (max-width: $postWidth) {
.contents {
display: none;
}
} |
2254ba4
to
535b7f6
Compare
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Pull Request Overview
This PR adds support for positioning the TOC on the side of the page based on a new configuration variable.
- Introduces a new parameter (displayTOConSide) to control TOC placement.
- Adjusts the TOC rendering logic in the post template and updates styling in SCSS files accordingly.
Reviewed Changes
Copilot reviewed 4 out of 4 changed files in this pull request and generated no comments.
File | Description |
---|---|
layouts/partials/pages/post.html | Adds logic to conditionally render TOC on the side or top. |
config-examples/zh-cn/config.toml | Adds a new configuration entry for TOC placement. |
assets/scss/main.scss | Introduces a variable to set TOC CSS position. |
assets/scss/layout/_single.scss | Applies the TOC position variable to the TOC container. |
Comments suppressed due to low confidence (2)
layouts/partials/pages/post.html:4
- [nitpick] Consider renaming $displayTOConSide to a more conventional variable name (e.g., $displayTocOnSide) for improved clarity and consistency with common naming practices.
{{ $displayTOConSide := default .Site.Params.displayTOConSide -}}
layouts/partials/pages/post.html:39
- [nitpick] The TOC inclusion logic appears in two separate condition blocks; consider refactoring this into a single, clear block to reduce duplication and potential maintenance overhead.
{{- if $enableTOC -}}
Due to #64, #368 and #387, many users want to display TOC on the side of their pages. I add a variable called
displayTOConSide
. If it's set tofalse
(by default), the TOC will be displayed on the top of the article; If it's set totrue
, the TOC will be displayed on the side of the article.The
position
of TOC will be set tofixed
ifdisplayTOConSide
is true. Users can DIY their style of TOC(such as on the left or right) by modifingcontents
in _single.scss.