crazy-toads.github.io/pages/readme.md
2017-08-08 21:53:28 +02:00

6 KiB

layout permalink title description
page /readme/ README - How to set up lanyon-plus jekyll theme README for setting up lanyon-plus jekyll theme on github pages or custom domain having static website

{% raw %}

lanyon-plus

Based on Jekyll theme: Lanyon by Mark Otto

Required edits:

_config.yml

  • Edit lines where text string foo is present with relevant information.
  • Add relevant author and owner information
    • For proper sidebar, meta info below post title, and footer bar, add at least twitter, google plus info under owner and sidebar section.
    • Uncomment and add relevant user names/keys to enable features, e.g., google analytics, disqus comments, twitter widget, google custom search.

CNAME

  • Read Using a custom domain with GitHub Pages for set-up details.
  • If you are hosting website on domain other than github.io, rename CNAME.sample file to CNAME, and add your custom domain name, e.g., example.com (only one domain is allowed), otherwise remove CNAME file if you want to host at default github.io.
  • If you are hosting website on github.io, replace example.com with https://<github-username>.github.io/<repository_name> (for project site) or https://<github-username>.github.io (for user site) under site.url and site.urlimg in _config.yml and _prose.yml file.

.travis.yml

_prose.yml

robots.txt

  • replace example.com with your valid url.
  • Edit search engine inclusion/exclusion if desired.

page specific edits

  • _data/socialmedia.html

    • Replace user foo with appropriate username
  • _includes/

    • Check if file paths for appropriate urls have valid css files, scripts, icons, and images in head.html and head_minimal.html, else comment html tags which are not being used.
    • Also, check if variables (twitter, google plus, linkedin, google analytics key and disqus username, etc.) are specified in _config.yml located under root path.
    • You may edit meta_info.html, footer.html and similar include files to add/remove elements in page meta bar, footer, etc.
    • For publications page, mypubs.html and myaoi.html are trimmed outputs from zot_bib_web. Github pages can not dynamically build these pages. Alternately, you may export bib format for publications under /files/ directory which can be parsed dynamically using bibbase.org
    • _includes/footer.html: Edit copyright information as needed.
  • _layouts

    • To add/remove/reorder page/post contents, edit default.html plus page.html or post.html.
  • _posts

    • Live blog posts goes here with markdown formatted post. File name format must have following date-title format yyyy-mm-dd-title.md for jekyll to render blog post correctly.
    • YAML sample header shows all available options. Minimal required elements are: layout, title and date. Date tag overrides date given in post file name.
  • blog/index.html

    • Edit blog title and description.
  • images/

    • Under icons directory, keep appropriate sized favicons and thumbnails as specified in _includes/head.html and _includes/head_minimal.html
    • Also, keep favicon.png and favicon.ico in root directory.
    • Final, images/icons/ should have following images with exact filenames and image size as specified in respective filenames. These images can be generated using online favicon generator. Replace foo with your site title or other name if desired.
example.com/images/icons/apple-touch-icon-precomposed.png
example.com/images/icons/apple-touch-icon-72x72-precomposed.png
example.com/images/icons/apple-touch-icon-114x114-precomposed.png
example.com/images/icons/apple-touch-icon-144x144-precomposed.png
example.com/images/icons/apple-touch-icon-180x180.png
example.com/images/icons/android-icon-192x192.png
  • pages/about.md
    • YAML variable imagefeature shoud have image path relative to images/ directory, i.e., foo.png will link to example.com/images/foo.png
    • Specify site.owner.avatar and site.owner.twitter along with other variables in _config.yml
  • syspages/:
    • Edit page title and description in YAML front matter.
    • For web search to work, specify Google Custom Search Engine API key for google_search variable.
    • Tag generation is experimental and dynamic size for tag box may need to be adjusted if you have more than 100 posts with one or two frequently occurring tags.
    • All {% for ... %}...{% endfor %} loop operations will increase site build time, and remove such features (tags, meta info, related posts, etc.) under _includes, _layouts and syspages if required.
  • pages/contact.md
    • Edit page title and description.
    • Edit address, driving direction url, etc.
  • pages/cv.md
    • Edit _config.yml to add twitter, google plus, linkedin, google scholar, ORCID profile info under owner heading.
    • Add pdf at {{ site.url }}/cv/cv.pdf
  • pages/publications.md
    • Add your publications at /files/mypubs.bib and _includes/mypubs.html. See above under _includes for more.
  • pages/disclosure.md
    • Appreciated if you keep relevant credits in disclosure page.
  • humans.txt
    • Replace foo with your name.
  • rfeed.xml
    • Not required unless you are cross-posting about R language on blog aggregation site(s).

END {% endraw %}