Skip to content

Git-based page histories v2.15.1

Word count
434 words
Reading time
3 minutes

Why

Just like what VueUse documentations site has, wouldn't a Git-based page histories be a great feature for your VitePress site?

Documentations engineering is a process of continuous improvement.

Most advanced content management systems, like those used by operating systems and knowledge bases (e.g., Wikipedia, Notion, Confluence, Outline), track the timestamp of the last edit on files and pages. Documenting the evolution of your content is crucial—it informs users of the most recent updates and identifies the contributors responsible for those changes. Including a changelog and a list of contributors is essential for transparency and acknowledgment.

Enter the @nolebase/vitepress-plugin-git-changelog plugin. It's a tool that generates changelogs and contributor lists, seamlessly integrating them into your VitePress site.

It harnesses the robust capabilities of git—a staple for developers, technical writers, and documentation specialists—to maintain a comprehensive log of revisions.

No need to setup and pay for additional databases, preparing operating systems, or subscribe to online services. Git logs are all you need.

Curious to see this feature in use? Try click Contributors and File History! 🚀

Features

Git logs are all you need. No service fees, online databases, or additional setup required.
Build-time generation of changelog and contributors sections
Instantly fast and reliable
Customizable to configure author name alias, email alias, display name mapping, etc.
Natively compatible with VitePress design
Follow the i18n guidelines of Nolebase Integrations
Best practices of a11y

Live use cases?

Yes for sure!

Installation

It is not that much easy and straightforward to install this plugin into your VitePress project. Luckily, we wrote good documentations! Please follow the steps under Getting started page.

Configuration

Git-based page histories plugin comes with many options to customize, including contributors info, and display texts! To learn more, please read Configuration page.

Contributors

Changelog

Layout Switch

Adjust the layout style of VitePress to adapt to different reading needs and screens.

Expand all
The sidebar and content area occupy the entire width of the screen.
Expand sidebar with adjustable values
Expand sidebar width and add a new slider for user to choose and customize their desired width of the maximum width of sidebar can go, but the content area width will remain the same.
Expand all with adjustable values
Expand sidebar width and add a new slider for user to choose and customize their desired width of the maximum width of sidebar can go, but the content area width will remain the same.
Original width
The original layout width of VitePress

Page Layout Max Width

Adjust the exact value of the page width of VitePress layout to adapt to different reading needs and screens.

Adjust the maximum width of the page layout
A ranged slider for user to choose and customize their desired width of the maximum width of the page layout can go.

Content Layout Max Width

Adjust the exact value of the document content width of VitePress layout to adapt to different reading needs and screens.

Adjust the maximum width of the content layout
A ranged slider for user to choose and customize their desired width of the maximum width of the content layout can go.

Spotlight

Highlight the line where the mouse is currently hovering in the content to optimize for users who may have reading and focusing difficulties.

ONOn
Turn on Spotlight.
OFFOff
Turn off Spotlight.

Spotlight Styles

Adjust the styles of Spotlight.

Under
Add a solid background color underneath the hovering element to highlight where the cursor is currently hovering.
Aside
Add a fixed line with solid color aside the hovering element to highlight where the cursor is currently hovering.