I am learning how do use git branch
and created a branch named like_andrew
(where I attach features like here )
This is a template for creating a mini Project website
- Internal link (only I can see): file://localhost/Users/luisamimmi/Github/MiniSiteTemplate
- Public link on GithubPages: https://lulliter.github.io/MiniSiteTemplate/
-
on Github: Create new repo
whateverthename
-
on Terminal (in the parent Local dir): Clone remote report
git clone "https://github.com/lulliter/whateverthename.git"
-
on Local: Copy the content of example
-
on Github: Scroll down to the Repo / Setting/ Github Pages section
click the drop down menu under “Source” and click “master branch”
-
on Local: make some adaptation / add content
-
(on Terminal/RStudio: Build the site locally (or see
./build_site.R
))- actually, now the shell script
./_render-deploy.sh
invokes and run./build_site.R
- actually, now the shell script
-
on Terminal/RStudio: git add/commit/push (or see
./_render-deploy.sh
)
R Markdown websites can be hosted using GitHub Pages in 2 ways
-
[IM USING THIS!] With two additions to the standard site configuration: + Add a file named
.nojekyll
to your site source code directory (this tells GitHub Pages to not process your site with the Jekyll engine). + Change your output directory to “.” within_site.yml
. For example:output_dir: "."
( using this configuration your source code, data, and everything else in your repository is all publicly available alongside your generated website content. ). -
Alternatively, you can configure GitHub Pages ⧉ to publish from a /docs subdirectory of your repository. If you work in this configuration you should change your output directory to “docs” within _site.yml. For example:
output_dir: "docs
"
This is built using the default Jekyll configuration found in Github check
-
Jekyll supports loading data from YAML, JSON, and CSV files located in the
_data
directory.- Note that CSV files must contain a header row.
-
Great tutorial Nick Strayer & Lucy D’Agostino McGowan
-
Key documentation: yihui
-
A minimal example here