View on GitHub

Settings_Website

Intructions, Tutorials and Settings for the new website

Website build

Last Update 2019-03-28 by Adam Lu

Followed the instructions for Install with Git from the Academic theme Quick-Start Guide:
- Installed Hugo
- Forked the academic-kickstart repository and cloned it to /media/shareX/Website:
```
cd /media/shareX
git clone https://github.com/sourcethemes/academic-kickstart.git Website
```
- Initialized the theme:
```
cd Website
git submodule update --init --recursive
```
- Removed the local git repository and started a new one
```
sudo rm -r .git*
git init
git add -A
git commit -a
```
- Created a private repository called Website on GitHub, then pushed the local git repository to it:
```
git remote add origin https://github.com/blabuva/Website.git
git push -u origin master
```
- Added the academic-kickstart repository as an upstream repository for themes/academic:
```
cd themes/academic
git remote add upstream https://github.com/sourcethemes/academic-kickstart.git
```

Consulted the instructions for Install with Git from the Academic theme Quick-Start Guide:

Duplicated the academic-kickstart repository to a new private repository called Website on GitHub per these instructions:

git clone --bare https://github.com/sourcethemes/academic-kickstart.git
cd academic-kickstart.git
git push --mirror https://github.com/blabuva/Website.git
cd ..
rm -rf academic-kickstart.git

Cloned the new repository to /media/shareX/Website:

cd /media/shareX
git clone https://github.com/blabuva/Website.git

Initialized the theme:

cd Website
git submodule update --init --recursive

Updated with the command:

  git submodule update --remote --merge

Started the Hugo server with drafts enabled:
```
hugo server -D
```

Followed the instructions from the Hugo Quick Start page:
- Installed Hugo:
```
sudo apt-get install hugo
```
- Created a new site from a template
```
hugo new site /media/shareX/Website
```
  Output:
  Congratulations! Your new Hugo site is created in /media/shareX/Website.
  
  Just a few more steps and you’re ready to go:
  1. Download a theme into the same-named folder. Choose a theme from https://themes.gohugo.io/, or create your own with the “hugo new theme " command.
  2. Perhaps you want to add some content. You can add single files with “hugo new /.".
  3. Start the built-in live server via “hugo server”.
  Visit https://gohugo.io/ for quickstart guide and full documentation.
- Added the Minimal theme:
```
# Initialize a git repository for /media/shareX/Website
cd /media/shareX/Website
git init
    
# Install the Minimal theme as a submodule
git submodule add https://github.com/calintat/minimal.git themes/minimal
    
# Activate the Minimal theme
git submodule init
git submodule update
```
- Added the Academic theme:
```
# Install the Academic theme as a submodule
git submodule add https://github.com/gcushen/hugo-academic.git themes/academic
```
- Updated the Minimal theme:
```
git submodule update --remote themes/minimal
```
- Copied the example configuration file
```
cp themes/minimal/exampleSite/config.toml .
```
- Committed the git repository
```
git add --all
git commit -a
```
- Delete the default archetypes (this will allow use of the theme’s archetypes):
```
rm archetypes/default.md
```
- Started the Hugo server with drafts enabled:
```
hugo server -D
```
Getting Started
- Created a Sublime Text project for /media/shareX/Website
- Consulted these instructions

Modifications 07/25/2018

Added the Bootstrap 4 theme:

git submodule add https://github.com/mmrath/hugo-bootstrap.git themes/hugo-bootstrap

Hosted the website on an AWS S3 bucket
- Created an S3 bucket with the name www.beenhakkerlab.org
- Under the Properties tab, then under Static website hosting, selected Use this bucket to host a website
- Typed index.html for the Index document and 404.html for the Error document
- Under the Permissions tab, then under Bucket Policy, added the following lines:
```
{
    "Version": "2012-10-17",
    "Statement": [
        {
        "Sid": "AddPerm1",
        "Effect": "Allow",
        "Principal": "*",
        "Action": "s3:GetObject",
        "Resource": "arn:aws:s3:::www.beenhakkerlab.org/*"
        }
    ]
}
```
- The website address is http://www.beenhakkerlab.org.s3-website.us-east-2.amazonaws.com
Hosted brain.how on an AWS S3 bucket
- The website address is http://brain.how.s3-website.us-east-2.amazonaws.com
Followed instructions from AWS to make Route 53 the DNS service for the Google domain brain.how
- First created a hosted zone with brain.how as the Domain Name
- Then within the hosted zone, created a new record set of type A - IPv4 address
- Selected Yes for Alias and entered s3-website-us-east-1.amazonaws.com
- Went back to hosted zones, clicked on the radio button for brain.how and copied the 4 name servers assigned.
- Logged in to Google domains, clicked on brain.how and then clicked on DNS on the left. Chose Use custom name servers and pasted the 4 Amazon name servers.
- Waited 24 hours for the DNS to propagate through the web.
Transferred the website to a new AWS S3 bucket
- Created an S3 bucket with the name beenhakkerlab.org
- Clicked on Copy settings from an existing bucket and chose www.beenhakkerlab.org
- Under the Properties tab, then under Static website hosting, selected Use this bucket to host a website
- Typed index.html for the Index document and 404.html for the Error document
- Under the Permissions tab, then under Bucket Policy, added the following lines:
```
{
    "Version": "2012-10-17",
    "Statement": [
        {
        "Sid": "AddPerm1",
        "Effect": "Allow",
        "Principal": "*",
        "Action": "s3:GetObject",
        "Resource": "arn:aws:s3:::beenhakkerlab.org/*"
        }
    ]
}
```
- The website address is http://beenhakkerlab.org.s3-website.us-east-2.amazonaws.com
- Used Cut and Paste to transfer everything from the www.beenhakker.org bucket to beenhakker.org
- Deleted the www.beenhakker.org bucket
Followed the same instructions as for brain.how to make Route 53 the DNS service for the Google domain beenhakker.org