My own version of the academic websites repository. This was forked (then detached) by Stuart Geiger from the Minimal Mistakes Jekyll Theme, which is © 2016 Michael Rose and released under the MIT License. See LICENSE.md. I (Timothy Stephens) forked this repository from academicpages on 2022-10-02.

The only major changes that I did was add R scripts for auto generating pages and CV files from csv files with all user info (i.e., build all the things at once).

R --slave -e "install.packages('pagedown', repos='http://cran.us.r-project.org')"

Note: if you are using this repo and now get a notification about a security vulnerability, delete the Gemfile.lock file.

Instructions

1. Register a GitHub account if you don't have one and confirm your e-mail (required!)
2. Fork this repository by clicking the "fork" button in the top right.
3. Go to the repository's settings (rightmost item in the tabs that start with "Code", should be below "Unwatch"). Rename the repository "[your GitHub username].github.io", which will also be your website's URL.
4. Set site-wide configuration and create content & metadata (see below -- also see this set of diffs showing what files were changed to set up an example site for a user with the username "getorg-testacct")
5. Upload any files (like PDFs, .zip files, etc.) to the files/ directory. They will appear at https://[your GitHub username].github.io/files/example.pdf.
6. Check status by going to the repository settings, in the "GitHub pages" section
7. (Optional) Use the Jupyter notebooks or python scripts in the markdown_generator folder to generate markdown files for publications and talks from a TSV file.

See more info at https://academicpages.github.io/

To run locally (not on GitHub Pages, to serve on your own computer)

1. Clone the repository and made updates as detailed above
2. Make sure you have ruby-dev, bundler, and nodejs installed: sudo apt install ruby-dev ruby-bundler nodejs
3. Run bundle clean to clean up the directory (no need to run --force)
4. Run bundle install to install ruby dependencies. If you get errors, delete Gemfile.lock and try again.
5. Run bundle exec jekyll liveserve to generate the HTML and serve it from localhost:4000 the local server will automatically rebuild and refresh the pages on change.

Locations of key files/directories

• Basic config options: _config.yml
• Top navigation bar config: _data/navigation.yml
• Single pages: _pages/
• Collections of pages are .md or .html files in:
  • _publications/
  • _portfolio/
  • _posts/
  • _teaching/
  • _talks/
• Footer: _includes/footer.html
• Static files (like PDFs): /files/
• Profile image (can set in _config.yml): images/profile.png

Tips and hints

• Name a file ".md" to have it render in markdown, name it ".html" to render in HTML.
• Go to the commit list (on your repo) to find the last version Github built with Jekyll.
  • Green check: successful build
  • Orange circle: building
  • Red X: error
  • No icon: not built

Resources

• Liquid syntax guide

Markdown guide

Header three

Header four

Header five

Header six

Blockquotes

Single line blockquote:

Quotes are cool.

Tables

Table 1

Entry	Item
John Doe	2016	Description of the item in the list
Jane Doe	2019	Description of the item in the list
Doe Doe	2022	Description of the item in the list

Table 2

Header1	Header2	Header3
cell1	cell2	cell3
cell4	cell5	cell6
-----------------------------
cell1	cell2	cell3
cell4	cell5	cell6
=============================
Foot1	Foot2	Foot3

Definition Lists

Definition List Title : Definition list division.

Startup : A startup company or startup is a company or temporary organization designed to search for a repeatable and scalable business model.

#dowork : Coined by Rob Dyrdek and his personal body guard Christopher "Big Black" Boykins, "Do Work" works as a self motivator, to motivating your friends.

Do It Live : I'll let Bill O'Reilly explain this one.

Unordered Lists (Nested)

• List item one
  • List item one
    • List item one
    • List item two
    • List item three
    • List item four
  • List item two
  • List item three
  • List item four
• List item two
• List item three
• List item four

Ordered List (Nested)

1. List item one
   1. List item one
      1. List item one
      2. List item two
      3. List item three
      4. List item four
   2. List item two
   3. List item three
   4. List item four
2. List item two
3. List item three
4. List item four

Buttons

Make any link standout more when applying the .btn class.

Notices

Watch out! You can also add notices by appending {: .notice} to a paragraph. {: .notice}

HTML Tags

Address Tag

1 Infinite Loop
Cupertino, CA 95014
United States

Anchor Tag (aka. Link)

This is an example of a link.

Abbreviation Tag

The abbreviation CSS stands for "Cascading Style Sheets".

*[CSS]: Cascading Style Sheets

Cite Tag

"Code is poetry." ---Automattic

Code Tag

You will learn later on in these tests that word-wrap: break-word; will be your best friend.

Strike Tag

This tag will let you strikeout text.

Emphasize Tag

The emphasize tag should italicize text.

Insert Tag

This tag should denote inserted text.

Keyboard Tag

This scarcely known tag emulates keyboard text, which is usually styled like the <code> tag.

Preformatted Tag

This tag styles large blocks of code.

.post-title {
  margin: 0 0 5px;
  font-weight: bold;
  font-size: 38px;
  line-height: 1.2;
  and here's a line of some really, really, really, really long text, just to see how the PRE tag handles it and to find out how it overflows;
}

Quote Tag

Developers, developers, developers… –Steve Ballmer

Strong Tag

This tag shows bold text.

Subscript Tag

Getting our science styling on with H₂O, which should push the "2" down.

Superscript Tag

Still sticking with science and Isaac Newton's E = MC², which should lift the 2 up.

Variable Tag

This allows you to denote variables.