Skip to content

setting up mkdocs-material on archlinux

installation

sudo pacman -S mkdocs-material python-pymdown-extensions

Also install python-paginate.

python-paginate PKGBUILD
pkgname=python-paginate
pkgver=0.1
pkgrel=1
pkgdesc='This module helps dividing large lists of items into pages. '
arch=('any')
url='https://github.com/Pylons/paginate'
license=('MIT')
depends=('python' 'python-click')
makedepends=('python-setuptools-scm' 'python-wheel' 'python-installer' 'python-build')
source=("${pkgname}.zip"::"https://github.com/Pylons/paginate/archive/refs/heads/master.zip")
sha256sums=('SKIP')

build() {
  cd "paginate-master"
  python -m build --wheel --no-isolation
}

package() {
  cd "paginate-master"
  python -m installer --destdir="$pkgdir" dist/*.whl
  install -Dvm644 'README.md' -t "${pkgdir}/usr/share/doc/${pkgname}"
  install -Dvm644 'LICENSE' -t "${pkgdir}/usr/share/licenses/${pkgname}"
}

I don't use this plugin. Just mentioning this here cause I made its PKGBUILD.

mkdocs-awesome-pages-plugin PKGBUILD
pkgname=python-mkdocs-awesome-pages
pkgver=0.1
pkgrel=1
pkgdesc='An MkDocs plugin that simplifies configuring page titles and their order'
arch=('any')
url='https://github.com/lukasgeiter/mkdocs-awesome-pages-plugin'
license=('MIT')
depends=('python' 'mkdocs' 'python-wcmatch' 'python-natsort')
makedepends=('python-setuptools-scm' 'python-wheel' 'python-installer' 'python-build')
source=("${pkgname}.zip"::"https://github.com/lukasgeiter/mkdocs-awesome-pages-plugin/archive/refs/heads/master.zip")
sha256sums=('SKIP')

build() {
  cd "mkdocs-awesome-pages-plugin-master"
  python -m build --wheel --no-isolation
}

package() {
  cd "mkdocs-awesome-pages-plugin-master"
  python -m installer --destdir="$pkgdir" dist/*.whl
  install -Dvm644 'README.md' -t "${pkgdir}/usr/share/doc/${pkgname}"
  install -Dvm644 'LICENSE.md' -t "${pkgdir}/usr/share/licenses/${pkgname}"
}

```title"mkdocs-minify PKGBUILD" pkgname=python-mkdocs-minify-plugin pkgver=0.1 pkgrel=1 pkgdesc='An MkDocs plugin to minify HTML, JS or CSS files prior to being written to disk.' arch=('any') url='https://github.com/byrnereese/mkdocs-minify-plugin' license=('MIT') depends=('python' 'mkdocs' 'python-htmlmin2' 'python-csscompressor' 'python-jsmin') makedepends=('python-setuptools-scm' 'python-wheel' 'python-installer' 'python-build') source=("${pkgname}.zip"::"https://github.com/byrnereese/mkdocs-minify-plugin/archive/refs/heads/main.zip") sha256sums=('SKIP')

build() { cd "mkdocs-minify-plugin-main" python -m build --wheel --no-isolation }

package() { cd "mkdocs-minify-plugin-main" python -m installer --destdir="$pkgdir" dist/*.whl install -Dvm644 'README.md' -t "${pkgdir}/usr/share/doc/${pkgname}" install -Dvm644 'LICENSE' -t "${pkgdir}/usr/share/licenses/${pkgname}" } 

## systemd service
```bash title="~/bin/mkdocs-server.sh"
#!/bin/bash

cd /home/vector/vectorspacexyz.github.io
mkdocs serve

~/.config/systemd/user/mkdocs-server.service
[Unit]
Description=Start the mkdocs server

[Service]
ExecStart='/home/vector/bin/mkdocs-server.sh'

[Install]
WantedBy=default.target

systemctl --user daemon-reload
systemctl --user start mkdocs-server.service
systemctl --user enable mkdocs-server.service

Comments