https://github.com/red/web-fullstack
fullstack.red site
https://github.com/red/web-fullstack
Last synced: 4 months ago
JSON representation
fullstack.red site
- Host: GitHub
- URL: https://github.com/red/web-fullstack
- Owner: red
- License: bsd-3-clause
- Created: 2018-07-24T21:39:05.000Z (almost 8 years ago)
- Default Branch: master
- Last Pushed: 2018-10-26T21:22:50.000Z (over 7 years ago)
- Last Synced: 2025-07-07T11:35:46.403Z (12 months ago)
- Language: HTML
- Size: 517 KB
- Stars: 0
- Watchers: 8
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: readme.md
- License: LICENSE
Awesome Lists containing this project
README
# Fullstack Technologies website
This is the site source.
## Building the site
1. Install Node 8+ (I recommend using [nvm](https://github.com/creationix/nvm) or [nvm-windows](https://github.com/coreybutler/nvm-windows/releases))
2. Install [Hugo](https://gohugo.io/getting-started/installing) - You can test that it's working by running `hugo` after the executable is available in your $PATH. If run from just any old directory, it should complain "unable to locate config file," which means it's working.
3. Install [Yarn](https://yarnpkg.com/en/)
4. Clone this repository
* If you are using HTTPS (not SSH), you'll need to update the submodule reference in your clone to the theme directory to HTTPS as well. See [this answer](https://stackoverflow.com/a/30885128/2486583).
5. Run `git submodule update --init --recursive` to initialize the theme submodule after cloning.
4. Go to the directory where you cloned this repo and run `yarn install` to install dependencies
5. Run `yarn start`
6. Visit http://localhost:1313
To build for production, run `yarn build`. The rendered site will be in the public/ dir.
See other scripts in package.json.
## Recommended dev environment
VS Code (this will use the workspace settings defined in .vscode/settings.json) with [ESLint](https://marketplace.visualstudio.com/items?itemName=dbaeumer.vscode-eslint), [Prettier](https://marketplace.visualstudio.com/items?itemName=esbenp.prettier-vscode), and [stylelint](https://marketplace.visualstudio.com/items?itemName=shinnn.stylelint) extensions installed. Linting and formatting will automatically run with a git hook, but these give you faster feedback.
## Working with the theme git submodule
To pull in submodule changes:
```
$ git submodule update --remote --merge
$ git commit -a -m "submodule updated"
```
To push changes made in theme submodule (while within themes/featherweight directory):
```
$ git commit -a -m "updates"
$ git push origin HEAD:
```
## Useful things
[Embed Responsively](http://embedresponsively.com/) will give you YouTube/Vimeo embed codes that work responsively (see 1up-media.html template partial for example).
Photos are not automatically resized when added through Netlify CMS, so resize/crush them before uploading.
Getting familiar with [Go templates](https://golang.org/pkg/text/template/) is very handy for working with Hugo. Here's a [good tutorial](https://code.tutsplus.com/tutorials/text-generation-with-go-templates--cms-30441).
Pretty printing Hugo variables for debug: https://gist.github.com/kaushalmodi/afb6c3e5098eccc028bddc91cf1eb53a
Find the right syntax for your YAML multiline strings - https://yaml-multiline.info/