Portfolio site template for those new to web development. Step by step video instructions can be found here: 📺
- RecrootBox was switched over from React.js to Gatsby.js on 2/20/20
- The instructions in the video above are geared toward deploying to github pages
- A new video with up-to-date instructions will be released shortly
- Fork this repository onto your own github account
- Clone the repository locally
- Make sure you have Node and NPM installed, then run
npm iin the newly cloned recrootBox folder - Open
recrootBox/src/siteData.jsand follow instructions in this file to add your information including your bio, image links, project titles, project links, etc. - Open
recrootBot/gatsby-config.jsand change thetitle,description,author, andtrackingId(google analytics).
Previously, I recommended using github pages to host the project. Recently, I've found netlify to be easier to use.
- Create a new site in netlify.
- Link your new netlify site to the recrootBox repo that you forked.
- In netlify deploy settings, specify
/buildas the content directory - In netlify deploy settings, specify
npm i && npm run buildas the deploy command
....................................................................................................................
As of 11/6/19, I added a blog to recrootBox. There are some details you need to be aware of if you want to use the blog.
I used github gists for the "back-end" of blog. gists are just code snippets. I used gists because they are easily accessible via an api call, and everyone with a github account has access to them already.
To get an idea for how gists are used, check out the gists that I used for my blog here
Its pretty simple; a gists can contain many files. For each blog post, i create a file within that gist, write the post and style it using github markdown
The only tricky part is the file title name. recrootBox uses these file names for rendering each post. Thus, they need to follow a specific naming construct or the posts won't load.
This is the construct: <post_title><underscore><underscore><month><underscore><day><underscore><year>.md
For example: This_is_my_blog_post!__10_31_19.md
These characters do wonky things to urls: < > # % { } | \ ^ ~ [ ] so don't use them in your file names
Each gist needs to have the following information formatting exactly as pictured below at the beginning of the file:
See how I've done this for each gist here
let blogName = "MY COOL BLOG";
let renderBlog = true;
let gistUrl = `https://api.github.com/gists/68cc754fb298f3121b5b2b4cfaa754d4`
blogNameis just the name of your blog. The name is desplayed in several places throughout the app.renderBlogis a boolean that renders the blog iftrueand doesn't iffalse, i.e. if you don't want the blog part of recrootBox, just set this to befalse.gistUrlis the url of the gist you want to use for your blog.

