Update docs

This commit is contained in:
Alan Grainger
2026-10-08 08:57:34 +13:00
parent aacbc1d79c
commit dbab0d3394
6 changed files with 117 additions and 28 deletions
+29
View File
@@ -1,3 +1,32 @@
/* Star-count pill in the navbar, after the GitHub icon. Shown at every width:
below 1280px the default theme hides the GitHub icon in its "..." menu, so
the pill is the only visible link to the repo there. */
.ipp-stars {
display: inline-flex;
align-items: center;
gap: 4px;
margin-left: 12px;
padding: 0 10px;
height: 28px;
border: 1px solid var(--vp-c-divider);
border-radius: 14px;
font-size: 13px;
font-weight: 500;
line-height: 1;
color: var(--vp-c-text-2);
transition: color 0.25s, border-color 0.25s;
}
.ipp-stars:hover {
color: var(--vp-c-text-1);
border-color: var(--vp-c-text-3);
}
.ipp-stars svg {
width: 16px;
height: 16px;
}
/* Landing-page hero tweaks for the screenshot-as-hero-image.
VitePress's default hero floats a square logo up-and-left; for a wide
screenshot we want it centred and vertically aligned with the hero text. */
+38 -20
View File
@@ -1,11 +1,48 @@
import DefaultTheme from 'vitepress/theme'
import { useData } from 'vitepress'
import { h } from 'vue'
import type { ThemeConfig } from '../config'
import './custom.css'
const DEMO_URL = 'https://demo.ipp.nz/s/demo-gallery'
const REPO_URL = 'https://github.com/alangrainger/immich-public-proxy'
// Material Design "star"
const STAR_PATH = 'M12 17.27 18.18 21l-1.64-7.03L22 9.24l-7.19-.61L12 2 9.19 8.63 2 9.24l5.46 4.73L5.82 21z'
/** 1234 as "1.2k", under a thousand as is. */
function formatStars (count: number): string {
return count >= 1000 ? (count / 1000).toFixed(1).replace(/\.0$/, '') + 'k' : String(count)
}
/**
* The GitHub star count as a navbar pill, after the GitHub icon. The count
* comes from the build (`themeConfig.stars`, see config.ts); nothing is
* rendered when the build had none.
*/
const StarCount = {
setup () {
const { theme } = useData<ThemeConfig>()
return () => {
const stars = theme.value.stars
if (stars === undefined) return null
return h('a', {
class: 'ipp-stars',
href: REPO_URL,
target: '_blank',
rel: 'noreferrer',
title: 'Star on GitHub',
'aria-label': stars + ' GitHub stars'
}, [
h('svg', { viewBox: '0 0 24 24', 'aria-hidden': 'true' }, [h('path', { fill: 'currentColor', d: STAR_PATH })]),
formatStars(stars)
])
}
}
}
/**
* Extend the default theme to:
* - show the GitHub star count in the navbar (`nav-bar-content-after`);
* - use the live-demo screenshot as the hero image (`home-hero-image`),
* absolutely centred within the hero image container so it lines up
* vertically with the hero text;
@@ -15,26 +52,7 @@ export default {
extends: DefaultTheme,
Layout () {
return h(DefaultTheme.Layout, null, {
'home-hero-actions-after': () => h(
'div',
{ style: 'display: flex; gap: 8px; margin-top: 24px; flex-wrap: wrap;' },
[
h('a', { href: 'https://github.com/alangrainger/immich-public-proxy', target: '_blank', rel: 'noreferrer' }, [
h('img', {
src: 'https://badgen.net/github/stars/alangrainger/immich-public-proxy?scale=1.1',
alt: 'GitHub stars',
style: 'vertical-align: middle;'
})
]),
h('a', { href: 'https://hub.docker.com/r/alangrainger/immich-public-proxy', target: '_blank', rel: 'noreferrer' }, [
h('img', {
src: 'https://badgen.net/docker/pulls/alangrainger/immich-public-proxy?icon=docker&label=docker%20pulls&color=green&scale=1.1',
alt: 'Docker pulls',
style: 'vertical-align: middle;'
})
])
]
),
'nav-bar-content-after': () => h(StarCount),
'home-hero-image': () => h(
'a',
{