0.0.332 • Published 9 months ago

@mavogel/projen-cdk-hugo-pipeline v0.0.332

Weekly downloads
-
License
Apache-2.0
Repository
github
Last release
9 months ago

projen-cdk-hugo-pipeline

This is a projen project template to manage the mavogel/cdk-hugo-pipeline repository. Please see the API for documentation.

Setup the boilerplate for a hugo blog with a CDK pipeline to deploy it to AWS :tada:

Usage

Quickly run the generator :tada:

General

which uses the blist in v2.1.0 by default:

# 1. create a new project directory
mkdir my-website &&  cd my-website

# 2. set up the project using the projen new command
npx projen new \
    --from @mavogel/projen-cdk-hugo-pipeline@~0 \
    --domain='example.com' \
    --projenrc-ts \
    --no-git

# 3. install dependencies for the theme (blist by default)
npm --prefix blog install

# 4. run the hugo development server
npm run dev

# 5. see if it builds correctly
npm run build-dev
npm run build # for production

Now open your browser and go to http://localhost:1313 to see the the website :tada:

See the API.md for more details and all possible configuration options.

If you want to deploy it follow the steps here in the cdk-hugo-pipeline repo.

For the AWS UG theme

from Kadir as a template for all AWS UGs. See here for the repo

# 1. create a new project directory
mkdir awsug-your-town &&  cd awsug-your-town

# 2. set up the project using the projen new command
npx projen new \
    --from @mavogel/projen-cdk-hugo-pipeline@~0 \
    --domain='your-domain.com' \
    --hugoThemeGitRepo='https://github.com/kkeles/awsug-hugo.git' \
    --hugoThemeGitRepoBranch='v1.2.0' \
    --hugoThemeSubmoduleStructure='themes/awsug' \
    --hugoThemeConfigFile='hugo.toml' \
    --projenrc-ts \
    --no-git

# 3. run the hugo development server
npm run dev

# 4. see if it builds correctly
npm run build-dev
npm run build-prod # for production

# 5. build it locally via
npm run build
# 6. deploy the repository and the pipeline once via
npm run deploy
## will create the codecommit repository and the codepipeline. 
## The pipeline will fail first, so now commit the code

# 7. add the remote, e.g. via GRPC http
git remote add origin codecommit::<aws-region>://your-blog
# 8. push the code and let the pipeline run
git push origin master
# 9. go to your 
## url dev.your-comain.com, 
## enter the basic auth credentials (default: john:doe)

Configuring the themes

You can have multiple themes, and use only one. Configure the hugo.toml or config.toml accordingly. See the setup andc configuring instructions here.

Adding

Add a theme by adding a gitmodule. See the stackoverflow post for details.

git submodule add https://github.com/apvarun/blist-hugo-theme.git blog/themes/blist
git submodule set-branch --branch v2.1.0 blog/themes/blist

Updating

You can also update a theme by updating the gitmodule and setting the branch or tag.

git submodule update blog/themes/blist
# set to new tag or branch
git submodule set-branch --branch v2.1.0 blog/themes/blist

Removing

Remove a theme by removing the gitmodule and the respective content .git folder.

export PATH_TO_THEME=blog/themes/blist
git submodule deinit -f $PATH_TO_THEME && rm -rf .git/modules/$PATH_TO_THEME && git rm -f $PATH_TO_THEME

How to contribute to Projen CDK Hugo Pipeline

Did you find a bug?

  • Ensure the bug was not already reported by searching on GitHub under Issues.

  • If you're unable to find an open issue addressing the problem, open a new one. Be sure to include a title and clear description, as much relevant information as possible, and a code sample or an executable test case demonstrating the expected behavior that is not occurring.

Did you write a patch that fixes a bug?

  • Open a new GitHub pull request with the patch.

  • Ensure the PR description clearly describes the problem and solution. Include the relevant issue number if applicable.

Did you fix whitespace, format code, or make a purely cosmetic patch?

Changes that are cosmetic in nature and do not add anything substantial to the stability, functionality, or testability will normally not be accepted. Please file an issue and we will add it together with the next feature or fix.

Do you intend to add a new feature or change an existing one?

  • Suggest your change under Issues.

  • Do not open a pull request on GitHub until you have collected positive feedback about the change.

Do you want to contribute to the CDK Serverless documentation?

  • Just file a PR with your recommended changes

Authors

Coded for you by MV Consulting

0.0.332

9 months ago

0.0.331

9 months ago

0.0.326

9 months ago

0.0.325

9 months ago

0.0.324

9 months ago

0.0.329

9 months ago

0.0.328

9 months ago

0.0.327

9 months ago

0.0.330

9 months ago

0.0.323

9 months ago

0.0.322

9 months ago

0.0.321

9 months ago

0.0.320

9 months ago

0.0.315

9 months ago

0.0.319

9 months ago

0.0.318

9 months ago

0.0.317

9 months ago

0.0.316

9 months ago

0.0.314

9 months ago

0.0.313

9 months ago

0.0.312

9 months ago

0.0.311

9 months ago

0.0.310

9 months ago

0.0.309

9 months ago

0.0.304

9 months ago

0.0.303

10 months ago

0.0.302

10 months ago

0.0.301

10 months ago

0.0.308

9 months ago

0.0.307

9 months ago

0.0.306

9 months ago

0.0.305

9 months ago

0.0.300

10 months ago

0.0.296

10 months ago

0.0.295

10 months ago

0.0.294

10 months ago

0.0.299

10 months ago

0.0.298

10 months ago

0.0.297

10 months ago

0.0.289

10 months ago

0.0.288

10 months ago

0.0.287

10 months ago

0.0.293

10 months ago

0.0.292

10 months ago

0.0.291

10 months ago

0.0.290

10 months ago

0.0.285

11 months ago

0.0.284

11 months ago

0.0.283

11 months ago

0.0.282

11 months ago

0.0.286

11 months ago

0.0.281

11 months ago

0.0.280

11 months ago

0.0.205

1 year ago

0.0.204

1 year ago

0.0.203

1 year ago

0.0.202

1 year ago

0.0.209

1 year ago

0.0.208

1 year ago

0.0.207

1 year ago

0.0.206

1 year ago

0.0.201

1 year ago

0.0.200

1 year ago

0.0.216

1 year ago

0.0.215

1 year ago

0.0.214

1 year ago

0.0.213

1 year ago

0.0.219

1 year ago

0.0.218

1 year ago

0.0.217

1 year ago

0.0.212

1 year ago

0.0.211

1 year ago

0.0.210

1 year ago

0.0.227

1 year ago

0.0.226

1 year ago

0.0.225

1 year ago

0.0.224

1 year ago

0.0.229

1 year ago

0.0.228

1 year ago

0.0.223

1 year ago

0.0.222

1 year ago

0.0.221

1 year ago

0.0.220

1 year ago

0.0.197

1 year ago

0.0.196

1 year ago

0.0.195

1 year ago

0.0.194

1 year ago

0.0.199

1 year ago

0.0.198

1 year ago

0.0.193

1 year ago

0.0.192

1 year ago

0.0.191

1 year ago

0.0.190

1 year ago

0.0.279

11 months ago

0.0.274

11 months ago

0.0.273

11 months ago

0.0.272

11 months ago

0.0.271

11 months ago

0.0.278

11 months ago

0.0.277

11 months ago

0.0.276

11 months ago

0.0.275

11 months ago

0.0.270

11 months ago

0.0.186

1 year ago

0.0.185

1 year ago

0.0.184

1 year ago

0.0.189

1 year ago

0.0.188

1 year ago

0.0.187

1 year ago

0.0.238

1 year ago

0.0.237

1 year ago

0.0.236

1 year ago

0.0.235

1 year ago

0.0.239

1 year ago

0.0.230

1 year ago

0.0.234

1 year ago

0.0.233

1 year ago

0.0.232

1 year ago

0.0.231

1 year ago

0.0.249

12 months ago

0.0.248

12 months ago

0.0.247

12 months ago

0.0.246

12 months ago

0.0.241

12 months ago

0.0.240

12 months ago

0.0.245

12 months ago

0.0.244

12 months ago

0.0.243

12 months ago

0.0.242

12 months ago

0.0.259

12 months ago

0.0.258

12 months ago

0.0.257

12 months ago

0.0.252

12 months ago

0.0.251

12 months ago

0.0.250

12 months ago

0.0.256

12 months ago

0.0.255

12 months ago

0.0.254

12 months ago

0.0.253

12 months ago

0.0.269

11 months ago

0.0.268

11 months ago

0.0.263

11 months ago

0.0.262

11 months ago

0.0.261

11 months ago

0.0.260

11 months ago

0.0.267

11 months ago

0.0.266

11 months ago

0.0.265

11 months ago

0.0.264

11 months ago

0.0.183

1 year ago

0.0.179

1 year ago

0.0.182

1 year ago

0.0.181

1 year ago

0.0.180

1 year ago

0.0.178

1 year ago

0.0.177

1 year ago

0.0.176

1 year ago

0.0.175

1 year ago

0.0.174

1 year ago

0.0.173

1 year ago

0.0.172

1 year ago

0.0.171

1 year ago

0.0.170

1 year ago

0.0.169

1 year ago

0.0.168

1 year ago

0.0.167

1 year ago

0.0.166

1 year ago

0.0.165

1 year ago

0.0.164

1 year ago

0.0.163

1 year ago

0.0.162

1 year ago

0.0.161

1 year ago

0.0.160

1 year ago

0.0.159

1 year ago

0.0.158

1 year ago

0.0.157

1 year ago

0.0.156

1 year ago

0.0.155

1 year ago

0.0.154

1 year ago

0.0.153

1 year ago

0.0.152

1 year ago

0.0.151

1 year ago

0.0.150

1 year ago

0.0.149

1 year ago

0.0.148

1 year ago

0.0.147

1 year ago

0.0.146

1 year ago

0.0.145

1 year ago

0.0.144

1 year ago

0.0.143

1 year ago

0.0.142

1 year ago

0.0.141

1 year ago

0.0.140

1 year ago

0.0.139

1 year ago

0.0.138

1 year ago

0.0.137

1 year ago

0.0.136

1 year ago

0.0.135

1 year ago

0.0.134

1 year ago

0.0.133

1 year ago

0.0.132

1 year ago

0.0.131

1 year ago

0.0.130

1 year ago

0.0.129

1 year ago

0.0.128

1 year ago

0.0.127

1 year ago

0.0.126

1 year ago

0.0.125

1 year ago

0.0.124

1 year ago

0.0.123

1 year ago

0.0.122

1 year ago

0.0.121

1 year ago

0.0.119

1 year ago

0.0.120

1 year ago

0.0.118

1 year ago

0.0.117

1 year ago

0.0.116

1 year ago

0.0.115

1 year ago

0.0.114

1 year ago

0.0.113

1 year ago

0.0.112

1 year ago

0.0.111

1 year ago

0.0.110

1 year ago

0.0.109

1 year ago

0.0.108

1 year ago

0.0.107

1 year ago

0.0.106

1 year ago

0.0.105

1 year ago

0.0.104

1 year ago

0.0.103

1 year ago

0.0.102

1 year ago

0.0.101

1 year ago

0.0.100

1 year ago

0.0.96

1 year ago

0.0.97

1 year ago

0.0.98

1 year ago

0.0.99

1 year ago

0.0.95

1 year ago

0.0.90

1 year ago

0.0.89

1 year ago

0.0.88

1 year ago

0.0.87

1 year ago

0.0.85

1 year ago

0.0.86

1 year ago

0.0.84

1 year ago

0.0.83

1 year ago

0.0.81

1 year ago

0.0.82

1 year ago

0.0.80

1 year ago

0.0.78

1 year ago

0.0.79

1 year ago

0.0.76

1 year ago

0.0.77

1 year ago

0.0.73

1 year ago

0.0.74

1 year ago

0.0.75

1 year ago

0.0.71

1 year ago

0.0.72

1 year ago

0.0.70

1 year ago

0.0.66

1 year ago

0.0.67

1 year ago

0.0.68

1 year ago

0.0.69

1 year ago

0.0.65

2 years ago

0.0.64

2 years ago

0.0.63

2 years ago

0.0.62

2 years ago

0.0.61

2 years ago

0.0.60

2 years ago

0.0.59

2 years ago

0.0.58

2 years ago

0.0.57

2 years ago

0.0.55

2 years ago

0.0.56

2 years ago

0.0.53

2 years ago

0.0.54

2 years ago

0.0.52

2 years ago

0.0.51

2 years ago

0.0.50

2 years ago

0.0.49

2 years ago

0.0.48

2 years ago

0.0.47

2 years ago

0.0.46

2 years ago

0.0.45

2 years ago

0.0.44

2 years ago

0.0.43

2 years ago

0.0.42

2 years ago

0.0.41

2 years ago

0.0.40

2 years ago

0.0.39

2 years ago

0.0.38

2 years ago

0.0.37

2 years ago

0.0.36

2 years ago

0.0.35

2 years ago

0.0.34

2 years ago

0.0.33

2 years ago

0.0.32

2 years ago

0.0.31

2 years ago

0.0.30

2 years ago

0.0.29

2 years ago

0.0.28

2 years ago

0.0.27

2 years ago

0.0.26

2 years ago

0.0.25

2 years ago

0.0.24

2 years ago

0.0.23

2 years ago

0.0.22

2 years ago

0.0.21

2 years ago

0.0.20

2 years ago

0.0.19

2 years ago

0.0.18

2 years ago

0.0.17

2 years ago

0.0.16

2 years ago

0.0.15

2 years ago

0.0.14

2 years ago

0.0.13

2 years ago

0.0.12

2 years ago

0.0.11

2 years ago

0.0.10

2 years ago

0.0.9

2 years ago

0.0.8

2 years ago

0.0.7

2 years ago

0.0.6

2 years ago

0.0.5

2 years ago

0.0.4

2 years ago

0.0.3

2 years ago

0.0.2

2 years ago

0.0.1

2 years ago