Skip to content

Commit f2b9ec5

Browse files
committed
Added documentations with MKDocs
1 parent f515d70 commit f2b9ec5

5 files changed

Lines changed: 105 additions & 0 deletions

File tree

.github/workflows/ci.yml

Lines changed: 29 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,29 @@
1+
name: ci
2+
on:
3+
push:
4+
branches:
5+
- master
6+
- main
7+
permissions:
8+
contents: write
9+
jobs:
10+
deploy:
11+
runs-on: ubuntu-latest
12+
steps:
13+
- uses: actions/checkout@v4
14+
- name: Configure Git Credentials
15+
run: |
16+
git config user.name github-actions[bot]
17+
git config user.email 41898282+github-actions[bot]@users.noreply.github.com
18+
- uses: actions/setup-python@v5
19+
with:
20+
python-version: 3.x
21+
- run: echo "cache_id=$(date --utc '+%V')" >> $GITHUB_ENV
22+
- uses: actions/cache@v4
23+
with:
24+
key: mkdocs-material-${{ env.cache_id }}
25+
path: ~/.cache
26+
restore-keys: |
27+
mkdocs-material-
28+
- run: pip install mkdocs-material
29+
- run: mkdocs gh-deploy --force

docs/customizations/index.md

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1 @@
1+
# Customizations

docs/how-to-use/index.md

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1 @@
1+
# How to Use

docs/index.md

Lines changed: 5 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,5 @@
1+
# Home
2+
3+
Welcome to the documentation for Linux Scripts by sysmonyx
4+
5+
## Objectives

mkdocs.yml

Lines changed: 69 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,69 @@
1+
# Site details
2+
site_name: Linux Scripts
3+
repo_name: sysmonyx/linux-scripts
4+
repo_url: https://github.com/sysmonyx/linux-scripts
5+
6+
# Static details
7+
copyright: Copyright © 2025 Soham Ray @sysmonyx
8+
9+
# Material for MKDocs theme configs
10+
theme:
11+
icon:
12+
logo: fontawesome/brands/linux
13+
repo: fontawesome/brands/github
14+
name: material
15+
palette:
16+
# Palette toggle for light mode
17+
- scheme: default
18+
primary: indigo
19+
accent: indigo
20+
toggle:
21+
icon: material/brightness-7
22+
name: Switch to dark mode
23+
24+
# Palette toggle for dark mode
25+
- scheme: slate
26+
primary: black
27+
accent: indigo
28+
toggle:
29+
icon: material/brightness-4
30+
name: Switch to light mode
31+
32+
font:
33+
text: IBM Plex Sans
34+
code: IBM Plex Mono
35+
features:
36+
- navigation.instant
37+
- navigation.tabs
38+
- navigation.sections
39+
- navigation.indexes
40+
- navigation.path
41+
- navigation.top
42+
- navigation.prune
43+
- navigation.tracking
44+
45+
# Navigation Configs
46+
nav:
47+
- Home:
48+
- index.md
49+
- How to Use:
50+
- how-to-use/index.md
51+
- Customizations:
52+
- customizations/index.md
53+
54+
# Extra Optimizations, Customizations, Plugins & Extensions
55+
extra:
56+
generator: false
57+
social:
58+
- icon: fontawesome/brands/github
59+
link: https://github.com/sysmonyx
60+
name: sysmonyx on GitHub
61+
- icon: fontawesome/brands/gitlab
62+
link: https://gitlab.com/sysmonyx
63+
name: sysmonyx on GitLab
64+
- icon: fontawesome/solid/paper-plane
65+
link: mailto:contact@sysmonyx.com
66+
name: Email
67+
68+
#extra_css:
69+
# - stylesheets/extra.css

0 commit comments

Comments
 (0)