https://github.com/bep/my-modular-site

Just a test site
https://github.com/bep/my-modular-site

Last synced: about 17 hours ago
JSON representation

Just a test site

• Host: GitHub
• URL: https://github.com/bep/my-modular-site
• Owner: bep
• Created: 2019-05-03T07:03:01.000Z (over 5 years ago)
• Default Branch: master
• Last Pushed: 2024-02-01T19:59:31.000Z (11 months ago)
• Last Synced: 2024-11-09T20:56:43.806Z (about 1 month ago)
• Language: HTML
• Homepage:
• Size: 32.2 KB
• Stars: 23
• Watchers: 5
• Forks: 14
• Open Issues: 0
• Metadata Files:
  • Readme: README.md

Awesome Lists containing this project

• awesome-starred-test - bep/my-modular-site - Just a test site (HTML)

README

        


Some notes

## Add or update a module

* TODO(bep) imports 

The following will add or update a module:

```bash

hugo mod get -u  github.com/bep/my-theme

```

## Update all modules

The following will update all modules to their latest minor or patch version:

```bash

hugo mod get -u

```

## Local development

Add a replace directive:

```bash

replace github.com/bep/hugotestmods/mypartials => /Users/bep/sites/hugomod/hugotestmods/mypartials

```

## Major versions

The simplest is to stick with v1 and increment minor and patch versions, e.g. `v1.0.0`, `v1.0.1`, `v1.1.0` and so on.

If you really need to release a new (breaking) major version, you can do this:

Edit your module's `go.mod` file and add the major version at the end of the path, e.g 

```

module github.com/bep/hugotestmods/myv2/v2

```

Then tag a new release version, e.g. `myv2/v2.0.0`.

**Note:** Hugo will currently only use one version of a given module (the first), so if you have a dependency that is depending on the `v1` version of that same module, but you really want to try out `v2`, then you must insert the `v2`-path higher up. The command `hugo mod graph` is useful in debugging these issues.

TODOS:

* More on v2

* GOPROXY="https://proxy.golang.org" seems to break/delay GitHub updates? 

* GO111MODULE=on