1
 2
 3
 4
 5
 6
 7
 8
 9
10

Run hugo --minify
Start building sites … 
hugo v0.125.7-b1d808bc373f53ad37c8966bb02a6aea095db5f8 linux/amd64 BuildDate=2024-05-08T14:46:24Z VendorInfo=gohugoio

WARN  deprecated: .Site.RSSLink was deprecated in Hugo v0.114.0 and will be removed in a future release. Use the Output Format's Permalink method instead, e.g. .OutputFormats.Get "RSS".Permalink
ERROR TOCSS: failed to transform "/sass/main.scss" (text/x-scss). Check your Hugo installation; you need the extended version to build SCSS/SASS with transpiler set to 'libsass'.: this feature is not available in your current Hugo version, see https://goo.gl/YMrWcn for more information
WARN  The author key in site configuration is deprecated. Use params.author.name instead.
Total in 1807 ms
Error: error building site: TOCSS: failed to transform "/sass/main.scss" (text/x-scss). Check your Hugo installation; you need the extended version to build SCSS/SASS with transpiler set to 'libsass'.: this feature is not available in your current Hugo version, see https://goo.gl/YMrWcn for more information
Error: Process completed with exit code 1.

1
2
3
4
5
6
7

Push the commit or tag
  /usr/bin/git push origin source
  git@github.com: Permission denied (publickey).
  fatal: Could not read from remote repository.
  Please make sure you have the correct access rights
  and the repository exists.
  Error: Action failed with "The process '/usr/bin/git' failed with exit code 128"

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30

The error message indicates that the peaceiris/actions-gh-pages@v4 action is encountering an issue with the provided GitHub token. The generated token (likely named GITHUB_TOKEN) doesn't have permissions to push to an external repository (which GitHub Pages essentially is). Here's how to fix this:

1. Choose the Right Authentication Method:

The action message suggests two alternative authentication methods:

deploy_key: This refers to using an SSH key for deployment. We've already discussed this approach in previous solutions.

personal_token: This is the recommended approach for most cases. A personal access token created specifically with permissions to push to your GitHub Pages repository is required.

2. Generate a Personal Access Token:

Go to your GitHub account settings: https://github.com/settings/tokens
Click on "Generate a new token."
Give your token a descriptive name (e.g., "Hugo-Deployment").
Select the scopes necessary for deployment. At minimum, you'll need the "repo" scope with "push" access. Granting additional scopes might be necessary depending on your workflow's needs. However, it's recommended to keep permissions minimal for security reasons.
Click on "Generate token" and copy the generated token.

3. Configure the Action:

There are two ways to provide the personal access token to the action:

Workflow Secrets: Store the token as a secret in your GitHub repository settings. Then, reference the secret name within your workflows/pages.yml file using the ${{ secrets.<SECRET_NAME> }} syntax. Replace <SECRET_NAME> with the actual name you assigned to the secret.

Environment Variables: Set an environment variable named GITHUB_TOKEN with the value of your personal access token within your workflow file. However, this approach exposes the token in the workflow logs, which is less secure than using secrets.

4. Update Workflow File:

Modify your workflows/pages.yml file to use the chosen authentication method (either deploy key or personal access token). Refer to the peaceiris/actions-gh-pages@v4 action documentation for specific syntax and configuration options related to authentication: https://github.com/peaceiris/actions-gh-pages#readme.

1
2
3
4
5

- name: Deploy
  uses: peaceiris/actions-gh-pages@v4
  with:
    personal_token: ${{ secrets.GITHUB_TOKEN }}
    publish_dir: ./public

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22

      - name: Build with Hugo
        run: hugo --minify
      - name: Upload artifact
        uses: actions/upload-pages-artifact@v3
        with:
          path: ./public

      # Deployment job
      - name: Deploy to GitHub Pages
        id: deployment
        uses: peaceiris/actions-gh-pages@v4 # https://github.com/peaceiris/actions-gh-pages#readme
        with:
          disable_nojekyll: true  # This line disables .nojekyll creation
          deploy_key: ${{ secrets.ACTIONS_DEPLOY_PRIVATE_KEY }}
          # personal_token: ${{ secrets.PERSONAL_TOKEN }}
          external_repository: hustbill/hustbill.github.io
          publish_branch:  gh-pages  # default: gh-pages
          publish_dir: ./public
          # allow_empty_commit: false
          keep_files: true
          commit_message: ${{ github.event.head_commit.message }}
          # force_orphan: true # This allows you to make your publish branch with only the latest commit.