Skip to content

lbliii/milodocs

Folders and files

NameName
Last commit message
Last commit date

Latest commit

ee96830 · Apr 18, 2025
Nov 15, 2024
Apr 18, 2025
Apr 18, 2025
May 1, 2024
Nov 18, 2024
Nov 17, 2024
May 1, 2024
Nov 26, 2023
Nov 18, 2024
Nov 7, 2024
Nov 26, 2023
Nov 17, 2024
Nov 7, 2024
Nov 26, 2023
Nov 7, 2024
Nov 7, 2024
May 1, 2024

Repository files navigation

MiloDocs

Features

  • native chatGPT UI
  • native Algolia UI

Installation

Quickstart (macOS)

  1. Copy and paste this into your terminal to install the theme as a git submodule and copy the default configs.
    brew install hugo 
    site_name="milodocs_$(date +%s%N | md5sum | head -c 8)"
    hugo new site "$site_name"
    cd "$site_name"
    git init
    git submodule add https://github.com/lbliii/milodocs themes/milodocs
    mkdir config/
    cp -r themes/milodocs/exampleSite/config/* config/
    rm config/_default/security.yaml
    rm hugo.toml
    git add .
    git commit -m "Initial commit"
    hugo server -D -p 1313
  2. Open localhost:1313
  3. Create your first markdown directory under content/ (for example, content/get-started).
  4. Add an _index.md file with the following frontmatter:
    ---
    title:
    description:
    weight:
    ---
  5. Check your site to see it displayed.

Getting from 0 to 1 takes ~5 minutes.

1.Install Hugo

brew install hugo

See Hugo Docs for more options:

2. Create a new site

hugo new site <siteName>

3.Install this project

  1. Open your <siteName> project directory.

  2. Navigate to the themes/ directory.

  3. Run the following command:

    gh repo clone lbliii/milodocs

4. Add theme to config

baseURL = 'https://example.org/'
languageCode = 'en-us'
title = 'My New Hugo Site'
theme = 'milodocs'

5. Init repo

Time to start saving your progress!

  1. Run the following:
    git init
  2. Add a comment.
  3. Push your new site and theme to your remote git repo.

6. Deploy locally

  1. Navigate into the siteName repo.
  2. Run the following:
    hugo server
  3. Open localhost (typically localhost:1313).