https://github.com/martinctc/blog

My static blog built based on Jekyll Now and template by privefl
https://github.com/martinctc/blog

Last synced: 24 days ago
JSON representation

My static blog built based on Jekyll Now and template by privefl

• Host: GitHub
• URL: https://github.com/martinctc/blog
• Owner: martinctc
• License: mit
• Created: 2019-04-13T17:29:23.000Z (over 5 years ago)
• Default Branch: master
• Last Pushed: 2024-08-08T16:21:45.000Z (3 months ago)
• Last Synced: 2024-08-08T20:10:43.230Z (3 months ago)
• Language: HTML
• Homepage: https://martinctc.github.io/blog
• Size: 92.1 MB
• Stars: 0
• Watchers: 2
• Forks: 1
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

        
## Implementation

See [privefl's Jekyll Now](https://github.com/privefl/jekyll-now-r-template) template and Barry Clark's [Jekyll Now](https://github.com/barryclark/jekyll-now).

This blog is built using a combination of:

- RMarkdown

- Jekyll (GitHub Pages generated)

- the {prettyjekyll} package

The static site is generated with Jekyll via GitHub Pages, rather than locally.

## Publishing

Posts from this blog can be found on:

- r-bloggers

- RWeekly.org

## Notes on {prettyjekyll}

Requirements and features of FormatPost

---------------------------------------

- Install package {prettyjekyll} using `devtools::install_github("privefl/prettyjekyll")`.

- The yaml header (delimited by '---') of you Rmd file needs to contain a title and a date.

- Function `prettyjekyll::FormatPost()`

    - renders your R Markdown as an HTML Pretty Document,

    

    - gets the main content of this HTML Pretty Document to put it in a new Markdown post that is rendered with Jekyll,

    

    - creates the name of the markdown file with the date and the title of your post,

    

    - makes some changes in figures' and images' paths to be recognized in the site. 

    

You can keep the default path to figures rendered by knitr. Caching is now supported starting with version 0.2.3. You should directly use the R Markdown template from this package.

## Repo structure

* `_posts` contains the final markdown files that are used for creating the blog. These are initially rendered by prettyjekyll, but may be edited manually to address issues with the original rendering.

* `_knitr` contains the initial RMarkdown files used for drafting the blog posts, and for generating the required markdown files. 

* Other files in the repo are either layout files for the blog, or static resources (such as images) used in the blog posts.

## Tags

* To add a tag to a post, update the markdown files in `_posts` directly. 

* To add a _new_ tag category, be sure to add a new markdown file under `blog/tag/`, following the layout and naming convention of the other files to match the tag name. This will make sure that a tagpage will be generated for the new tag category.