From b1b76bcb23232759147d7e5b197e3cba2e251cd8 Mon Sep 17 00:00:00 2001 From: "guangzheng.li" Date: Thu, 18 Aug 2022 21:14:22 +0800 Subject: [PATCH] feat: modify README.md --- README.md | 61 +++++++++++++++++++++++++++++++------------------------ 1 file changed, 34 insertions(+), 27 deletions(-) diff --git a/README.md b/README.md index be16767..e5615e7 100644 --- a/README.md +++ b/README.md @@ -2,8 +2,6 @@

🌈 Clean | ⏩ Fast | πŸ“° Focus on Reading | 🌐 Multi language | πŸŒ™ Multi Dark Theme | πŸ“± Mobile support

-> Hugo Ladder is a theme based on [hugo-paperMod](https://github.com/adityatelange/hugo-PaperMod). - The [Demo | ExampleSite](https://hugo-ladder.pages.dev/) includes a lot of documentation about Installation, Features with a few more stuff. Make sure you visit it, to get an awesome hands-on experience and get to know about the features ... Demo is built up with [exampleSite Source Code](https://github.com/guangzhengli/hugo-ladder-exampleSite) (https://github.com/guangzhengli/hugo-ladder-exampleSite) as source. @@ -13,47 +11,56 @@ Demo is built up with [exampleSite Source Code](https://github.com/guangzhengli/ ---

- Mockup image + Ladder image

+ --- -## how to install +## Quick Start -```shell -hugo new site -``` +Just click `Use this template` to create your blog site in the [exampleSite Source Code](https://github.com/guangzhengli/hugo-ladder-exampleSite). -```shell -git init +Create a new repository(GitHub Pages) from hugo-ladder-exampleSite to enter : `username.github.io`. -git add . +**replace the username by your GitHub account** -git commit -m "feat: init blog by hugo" +Then configure the GitHub page setting following: -git remote add origin git@github.com:guangzhengli/blog.git +![nsrExo](https://cdn.jsdelivr.net/gh/guangzhengli/PicURL@master/uPic/nsrExo.png) -git push --set-upstream origin master +πŸŽ‰πŸŽ‰πŸŽ‰ Open the browser and enter: https://username.github.io πŸŽ‰πŸŽ‰πŸŽ‰ -git push -``` +## Minimal Configuration -```shell -git submodule add https://github.com/guangzhengli/hugo-theme-ladder themes/hugo-theme-ladder +Clone your repository. -git submodule update --remote +Build and run hugo server by `hugo server -D` and open in browser http://localhost:1313/. -git add . +```yml +baseURL: 'https://hugo-ladder.pages.dev' # set https://username.github.io +homepage: 'https://hugo-ladder.pages.dev' # set https://username.github.io +defaultContentLanguage: 'en' #default language +params: + brand: HOME # set the brand of your site + avatarURL: /images/avatar.png # avatar, replace your avatar in the /static/images/ + author: Hugo Ladder # name + authorDescription: # description + info: this is a info # information of your blog site + favicon: /images/avatar.png # blog site icon,replace your avatar in the /static/images/ + options: + showDarkMode: true # is show dark mode button + enableMultiLang: true # is show multi language button +``` -git commit -m "feat: git submodule updated" +Modifying the default configuration. Then push it to your repository. -git push -``` +## ALL Configuration -copy config.toml to your site config.toml +Following this [article](https://guangzhengli.com/blog/en/how-to-create-your-blog-for-free-by-hugo-ladder-in-30min/) to cofiguration. -``` -theme = "hugo-theme-ladder" -``` +Following this [article](https://guangzhengli.com/blog/en/how-to-integrate-umami-for-free-to-blog-site/) to configure the umami analytics + +## Special Thanks -Build your site with hugo server and see the result at http://localhost:1313/. +* Hugo Ladder is inspired by [hugo-paperMod](https://github.com/adityatelange/hugo-PaperMod).