hugofy README

This is a modified Hugofy extension with extra support for hugo Page Bundles

Hugofy is a plugin for Visual Studio Code to make life easier to use Hugo static site generator

Features

1. Create new hugo site

2. Create posts (support right click on folder)

3. Build site

4. Run and stop server

5. Download available hugo themes.

6. Right click on current folder to Create post relative to current folder

7. Auto normalize path name to slug friendly path

   Currently supports, but not limited to, the following scripts:

   • Latin: e.g. English, français, Deutsch, español, português

   For example:

   Cyrillic: Я люблю русский/index.md => ya-lyublyu-russkij/index.md

Usage

Use command pallete Ctrl+Shift+P and type Hugofy Once the server has been started you can view the output by directing your browser to: http://localhost:9081

create post via command pallete Ctrl+Shift+P, the file path is relative to content/post directory.

create post via right click on current folder, the file path is relative to current folder.

How to reset theme config

this extension saved current theme name in .vscode/launch.json.

you can set new theme for this extension with the Hugoy: Set Theme command via command pallete (press Ctrl+Shift+P to enter)

Extension Settings

How to contribute (for extension developer users)

eamodio.tsl-problem-matcher extension provides $ts-webpack, you need install it:

ext install eamodio.tsl-problem-matcher

git clone https://github.com/ttys3/hugofy-vscode.git
cd ./hugofy-vscode
code .
# press F5 start

Known Issues

theme specific config

for some themes which need specific config,

you'll need copy config to your config.toml from themes/[Hugo theme name]/exampleSite/config.toml after new theme installed,

otherwise the theme will not work

default keyindings

the default keybindings, for example ctrl+shift+h s means press ctrl+shift+h first and release, then press s. it may shadows the default ctrl+shift+h keybinding which used for Search: Replace in Files, you can change the extension keybindings yourself if you really need get the original ctrl+shift+h keybinding back.

Release Notes

0.3.4

• refactor: prefetch theme list: only work on a hugo project
• refactor: new post prompt: default filename to empty. slug: only process latin1

0.3.3

• fix: fixup default keybindings

0.3.2

• refactor: add default keybindings, show message on success build

0.3.1

• refactor: change theme config key to hugo.defaultTheme since launch.json is general
• fix: fix extension recommendations

0.3.0

• fix: theme dir for xxx-theme or theme-xxx
• fix: do not check theme exists on non-hugo site directory

0.2.9

• fix: newPost: show detailed error message
• fix: set correct theme name from config on extension activation
• fix: check theme exists, if not, notify the user to "Set Theme"

0.2.8

• fix: fixup path problem under Windows

0.2.7

• refactor: add actions when theme download failed or succeed

0.2.6

• refactor: optimized download theme feature

0.2.5

• fix: Windows path separator

0.2.4

• refactor: check hugo in PATH or not, if not notify the user
• fix: show detailed build error

0.2.3

• refactor: show hugo server start error details

0.2.2

• refactor: optimized set theme and download theme feature

0.2.1

• refactor: open local hugo blog: prevent browser cache problem

0.2.0

• fix: check theme set or not before newPost(), show detailed error on new site error

0.1.9

• docs: update README.md

0.1.8

• fix: fixup set theme

0.1.7

• fix: fixup theme download

0.1.6

• refactor: refine console log
• docs: update development document

0.1.5

• use transliteration instead of limax which cause problem under webpack and has too many dependencies

• use webpack to bundle the extension, thanks this PR

0.1.4

• chore: fixup getThemesList.ts line ending (CRLF to LF)
• docs: updated CHANGELOG.md and README.md

0.1.3

• chore: extension logo added

0.1.2

• docs: updated CHANGELOG.md and README.md

0.1.1

• refactor: lint the code, more friendly error message
• fix: do not start the server again if already started
• feat: add New Post action on current folder right click event
• feat: support normalize path name to slug friendly path

0.1.0

[Fix] Fixed start server error

0.0.2

[Fix] Server Stop works on windows

0.0.1

Initial Release