Skip to content

Commit c2acf06

Browse files
Create README.md
1 parent 17a9058 commit c2acf06

1 file changed

Lines changed: 33 additions & 0 deletions

File tree

README.md

Lines changed: 33 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,33 @@
1+
# cegrcode.github.io
2+
Pugh Lab Website at Cornell.
3+
4+
From a web technology standpoint this is built using [jekyll](https://jekyllrb.com/). Even though there are other static site generators
5+
that can be deployed and hosted on GitHub, we chose [jekyll](https://jekyllrb.com/) as it is natively supported by GitHub, easy to learn,
6+
easy to integrate and configure DNS services, both GitHub and [jekyll](https://jekyllrb.com/) built using the same programming language
7+
[ruby](https://www.ruby-lang.org/en/) and also it is free to host among other things.
8+
9+
> Note: Even though it is based on ruby, we will not be writing any code in ruby.
10+
11+
### Dependencies
12+
13+
- Install jekyll [requirements](https://jekyllrb.com/docs/installation/).
14+
- Now install [jekyll](https://github.com/CEGRcode/cegrcode.github.io.git) itself.
15+
16+
> Note: This [step-by-step tutorial](https://jekyllrb.com/docs/step-by-step/01-setup/) covers all the basic concepts in building sites with jekyll. Highly recommend
17+
going though it on your local machine for fun. Takes about ~1hr.
18+
19+
### Local development
20+
21+
- Clone the repo from github.
22+
- Make your edits.
23+
- To view your changes type in the below command in your terminal from the root directory.
24+
- `bundle exec jekyll serve`
25+
- This should launch the website locally, usually at `http://localhost:4000/` you do not need MAMP, WAMP or any other platform for developement or production.
26+
27+
### Deployment
28+
29+
- `git push` or `merging` into to the `main` branch of this repo will automatically build and deploy your changes to production. These changes should be visible
30+
within a few minutes depending on time taken by GitHub to process it.
31+
- `CNAME` file contains the DNS entry.
32+
- `.gitignore` is setup to ignore all temporary files generated during local development. Feel free to add others if you need to.
33+

0 commit comments

Comments
 (0)