Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Document MacOS M1 errors #832

Merged
merged 1 commit into from
Nov 9, 2022
Merged

Document MacOS M1 errors #832

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
2 changes: 1 addition & 1 deletion README.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -22,7 +22,7 @@ To install, follow the [installation instructions for your Operating System](htt
1. Preview your site in your browser at: http://localhost:1313/
1. As you make changes to the site, your browser will automatically reload your local dev site so you can easily and quickly see your changes.

MacOS users getting `fatal error: pipe failed`, please see our [Troubleshooting guide](./troubleshooting.md).
MacOS users getting errors when running `hugo server`, please see our [Troubleshooting guide](./troubleshooting.md).

## Link Checking [Optional]

Expand Down
17 changes: 16 additions & 1 deletion troubleshooting.md
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -1,7 +1,8 @@
# Troubleshooting

## MacOS Hugo "fatal error: pipe failed"
## MacOS

### Hugo "fatal error: pipe failed"
MacOS users encountering the `fatal error: pipe failed` error when running `hugo server` need to run these commands:

```shell
Expand All @@ -26,3 +27,17 @@ hugo server
Save this in file with the `.commmand` suffix (e.g. `cht-docs-server.command`) to enable an easy double clicking to start the server.

Note - be sure to enter your MacOS user password in the terminal when prompted.

### Hugo "Error: failed to download modules: binary with name "go" not found"
MacOS M1 users encountering `Error: failed to download modules: binary with name "go" not found` when running `hugo server` need to install Golang by running:

```shell
brew install golang
```

### Hugo "Error: Error building site: POSTCSS"
MacOS M1 users encountering `Error: Error building site: POSTCSS: failed to transform "scss/main.css" (text/css)` when running `hugo server` need to install `postcss-cli` by running:

```shell
npm install postcss-cli
```