diff --git a/docs/Gemfile.lock b/docs/Gemfile.lock index 35097c4..48c266a 100644 --- a/docs/Gemfile.lock +++ b/docs/Gemfile.lock @@ -53,8 +53,10 @@ GEM ffi (1.16.3) forwardable-extended (2.6.0) gemoji (4.1.0) - google-protobuf (3.25.3-aarch64-linux) - google-protobuf (3.25.3-x86_64-linux) + google-protobuf (4.26.1-aarch64-linux) + rake (>= 13) + google-protobuf (4.26.1-x86_64-linux) + rake (>= 13) html-pipeline (2.14.3) activesupport (>= 2) nokogiri (>= 1.4) @@ -147,7 +149,8 @@ GEM mini_racer (0.12.0) libv8-node (~> 21.7.2.0) minitest (5.22.3) - multi_xml (0.6.0) + multi_xml (0.7.1) + bigdecimal (~> 3.1) mutex_m (0.2.0) namae (1.2.0) racc (~> 1.7) @@ -159,6 +162,7 @@ GEM forwardable-extended (~> 2.6) public_suffix (5.0.5) racc (1.7.3) + rake (13.2.1) rb-fsevent (0.11.2) rb-inotify (0.10.1) ffi (~> 1.0) @@ -166,10 +170,10 @@ GEM strscan (>= 3.0.9) rouge (4.2.1) safe_yaml (1.0.5) - sass-embedded (1.69.5-aarch64-linux-gnu) - google-protobuf (~> 3.23) - sass-embedded (1.69.5-x86_64-linux-gnu) - google-protobuf (~> 3.23) + sass-embedded (1.77.0-aarch64-linux-gnu) + google-protobuf (>= 3.25, < 5.0) + sass-embedded (1.77.0-x86_64-linux-gnu) + google-protobuf (>= 3.25, < 5.0) sax-machine (1.3.2) strscan (3.1.0) terminal-table (3.0.2) diff --git a/docs/README.md b/docs/README.md new file mode 100644 index 0000000..bb70f54 --- /dev/null +++ b/docs/README.md @@ -0,0 +1,458 @@ +# al-folio + +
+ +[![Preview](readme_preview/al-folio-preview.png)](https://alshedivat.github.io/al-folio/) + +**A simple, clean, and responsive [Jekyll](https://jekyllrb.com/) theme for academics.** + +--- + +[![deploy](https://github.com/alshedivat/al-folio/actions/workflows/deploy.yml/badge.svg)](https://github.com/alshedivat/al-folio/actions/workflows/deploy.yml) +[![Maintainers](https://img.shields.io/badge/maintainers-4-success.svg)](#maintainers) +[![GitHub contributors](https://img.shields.io/github/contributors/alshedivat/al-folio.svg)](https://github.com/alshedivat/al-folio/graphs/contributors/) +[![Docker Image Version](https://img.shields.io/docker/v/amirpourmand/al-folio?sort=semver&label=docker%20image&color=blueviolet)](https://hub.docker.com/r/amirpourmand/al-folio) +[![Docker Image Size](https://img.shields.io/docker/image-size/amirpourmand/al-folio?sort=date&label=docker%20image%20size&color=blueviolet)](https://hub.docker.com/r/amirpourmand/al-folio) +[![Docker Pulls](https://img.shields.io/docker/pulls/amirpourmand/al-folio?color=blueviolet)](https://hub.docker.com/r/amirpourmand/al-folio) + +[![GitHub release](https://img.shields.io/github/v/release/alshedivat/al-folio)](https://github.com/alshedivat/al-folio/releases/latest) +[![GitHub license](https://img.shields.io/github/license/alshedivat/al-folio?color=blue)](https://github.com/alshedivat/al-folio/blob/master/LICENSE) +[![GitHub stars](https://img.shields.io/github/stars/alshedivat/al-folio)](https://github.com/alshedivat/al-folio) +[![GitHub forks](https://img.shields.io/github/forks/alshedivat/al-folio)](https://github.com/alshedivat/al-folio/fork) + +
+ +## User community + +The vibrant community of **al-folio** users is growing! +Academics around the world use this theme for their homepages, blogs, lab pages, as well as webpages for courses, workshops, conferences, meetups, and more. +Check out the community webpages below. +Feel free to add your own page(s) by sending a PR. + + + + + + + + + + + + + + + + + + +
Academics + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
Labs + + + + + + + + +
Courses +CMU PGM (S-19)
+CMU DeepRL (S-21, F-21, S-22, F-22, S-23, F-23)
+CMU MMML (F-20, F-22)
+CMU AMMML (S-22, S-23)
+CMU ASI (S-23)
+CMU Distributed Systems (S-24) +
Conferences & workshops +ICLR Blog Post Track (2023, 2024)
+ML Retrospectives (NeurIPS: 2019, 2020; ICML: 2020)
+HAMLETS (NeurIPS: 2020)
+ICBINB (NeurIPS: 2020, 2021)
+Neural Compression (ICLR: 2021)
+Score Based Methods (NeurIPS: 2022)
+Images2Symbols (CogSci: 2022)
+Medical Robotics Junior Faculty Forum (ISMR: 2023)
+Beyond Vision: Physics meets AI (ICIAP: 2023)
+Workshop on Diffusion Models (NeurIPS: 2023) +
+ +## Lighthouse PageSpeed Insights + +### Desktop + +[![Google Lighthouse PageSpeed Insights](lighthouse_results/desktop/pagespeed.svg)](https://htmlpreview.github.io/?https://github.com/alshedivat/al-folio/blob/master/lighthouse_results/desktop/alshedivat_github_io_al_folio_.html) + +Run the test yourself: [Google Lighthouse PageSpeed Insights](https://pagespeed.web.dev/report?url=https%3A%2F%2Falshedivat.github.io%2Fal-folio%2F&form_factor=desktop) + +### Mobile + +[![Google Lighthouse PageSpeed Insights](lighthouse_results/mobile/pagespeed.svg)](https://htmlpreview.github.io/?https://github.com/alshedivat/al-folio/blob/master/lighthouse_results/mobile/alshedivat_github_io_al_folio_.html) + +Run the test yourself: [Google Lighthouse PageSpeed Insights](https://pagespeed.web.dev/report?url=https%3A%2F%2Falshedivat.github.io%2Fal-folio%2F&form_factor=mobile) + +## Table Of Contents + +- [al-folio](#al-folio) + - [User community](#user-community) + - [Lighthouse PageSpeed Insights](#lighthouse-pagespeed-insights) + - [Desktop](#desktop) + - [Mobile](#mobile) + - [Table Of Contents](#table-of-contents) + - [Getting started](#getting-started) + - [Installing and Deploying](#installing-and-deploying) + - [Customizing](#customizing) + - [Features](#features) + - [Light/Dark Mode](#lightdark-mode) + - [CV](#cv) + - [People](#people) + - [Publications](#publications) + - [Collections](#collections) + - [Layouts](#layouts) + - [The iconic style of Distill](#the-iconic-style-of-distill) + - [Full support for math \& code](#full-support-for-math--code) + - [Photos, Audio, Video and more](#photos-audio-video-and-more) + - [Other features](#other-features) + - [GitHub's repositories and user stats](#githubs-repositories-and-user-stats) + - [Theming](#theming) + - [Social media previews](#social-media-previews) + - [Atom (RSS-like) Feed](#atom-rss-like-feed) + - [Related posts](#related-posts) + - [Code quality checks](#code-quality-checks) + - [FAQ](#faq) + - [Contributing](#contributing) + - [Maintainers](#maintainers) + - [All Contributors](#all-contributors) + - [Star History](#star-history) + - [License](#license) + +## Getting started + +Want to learn more about Jekyll? Check out [this tutorial](https://www.taniarascia.com/make-a-static-website-with-jekyll/). Why Jekyll? Read [Andrej Karpathy's blog post](https://karpathy.github.io/2014/07/01/switching-to-jekyll/)! Why write a blog? Read [Rachel Thomas blog post](https://medium.com/@racheltho/why-you-yes-you-should-blog-7d2544ac1045). + +## Installing and Deploying + +For installation and deployment details please refer to [INSTALL.md](INSTALL.md). + +## Customizing + +For customization details please refer to [CUSTOMIZE.md](CUSTOMIZE.md). + +## Features + +### Light/Dark Mode + +This template has a built-in light/dark mode. It detects the user preferred color scheme and automatically switches to it. You can also manually switch between light and dark mode by clicking on the sun/moon icon in the top right corner of the page. + +

+ + +

+ +--- + +### CV + +There are currently 2 different ways of generating the CV page content. The first one is by using a json file located in [assets/json/resume.json](assets/json/resume.json). It is a [known standard](https://jsonresume.org/) for creating a CV programmatically. The second one, currently used as a fallback when the json file is not found, is by using a yml file located in [\_data/cv.yml](_data/cv.yml). This was the original way of creating the CV page content and since it is more human readable than a json file we decided to keep it as an option. + +What this means is, if there is no resume data defined in [\_config.yml](_config.yml) and loaded via a json file, it will load the contents of [\_data/cv.yml](_data/cv.yml) as fallback. + +[![CV Preview](readme_preview/cv.png)](https://alshedivat.github.io/al-folio/cv/) + +--- + +### People + +You can create a people page if you want to feature more than one person. Each person can have its own short bio, profile picture, and you can also set if every person will appear at the same or opposite sides. + +[![People Preview](readme_preview/people.png)](https://alshedivat.github.io/al-folio/people/) + +--- + +### Publications + +Your publications' page is generated automatically from your BibTex bibliography. Simply edit [\_bibliography/papers.bib](_bibliography/papers.bib). You can also add new `*.bib` files and customize the look of your publications however you like by editing [\_pages/publications.md](_pages/publications.md). By default, the publications will be sorted by year and the most recent will be displayed first. You can change this behavior and more in the `Jekyll Scholar` section in [\_config.yml](_config.yml) file. + +You can add extra information to a publication, like a PDF file in the [assets/pdf/](assets/pdf/) directory and add the path to the PDF file in the BibTeX entry with the `pdf` field. Some of the supported fields are: `abstract`, `altmetric`, `arxiv`, `bibtex_show`, `blog`, `code`, `dimensions`, `doi`, `eprint`, `html`, `isbn`, `pdf`, `pmid`, `poster`, `slides`, `supp`, `video`, and `website`. + +[![Publications Preview](readme_preview/publications.png)](https://alshedivat.github.io/al-folio/publications/) + +--- + +### Collections + +This Jekyll theme implements `collections` to let you break up your work into categories. The theme comes with two default collections: `news` and `projects`. Items from the `news` collection are automatically displayed on the home page. Items from the `projects` collection are displayed on a responsive grid on projects page. + +[![Projects Preview](readme_preview/projects.png)](https://alshedivat.github.io/al-folio/projects/) + +You can easily create your own collections, apps, short stories, courses, or whatever your creative work is. To do this, edit the collections in the [\_config.yml](_config.yml) file, create a corresponding folder, and create a landing page for your collection, similar to `_pages/projects.md`. + +--- + +### Layouts + +**al-folio** comes with stylish layouts for pages and blog posts. + +#### The iconic style of Distill + +The theme allows you to create blog posts in the [distill.pub](https://distill.pub/) style: + +[![Distill Preview](readme_preview/distill.png)](https://alshedivat.github.io/al-folio/blog/2021/distill/) + +For more details on how to create distill-styled posts using `` tags, please refer to [the example](https://alshedivat.github.io/al-folio/blog/2021/distill/). + +#### Full support for math & code + +**al-folio** supports fast math typesetting through [MathJax](https://www.mathjax.org/) and code syntax highlighting using [GitHub style](https://github.com/jwarby/jekyll-pygments-themes). Also supports [chartjs charts](https://www.chartjs.org/), [mermaid diagrams](https://mermaid-js.github.io/mermaid/#/), and [TikZ figures](https://tikzjax.com/). + +

+ + +

+ +#### Photos, Audio, Video and more + +Photo formatting is made simple using [Bootstrap's grid system](https://getbootstrap.com/docs/4.4/layout/grid/). Easily create beautiful grids within your blog posts and project pages, also with support for [video](https://alshedivat.github.io/al-folio/blog/2023/videos/) and [audio](https://alshedivat.github.io/al-folio/blog/2023/audios/) embeds: + +

+ + + +

+ +--- + +### Other features + +#### GitHub's repositories and user stats + +**al-folio** uses [github-readme-stats](https://github.com/anuraghazra/github-readme-stats) and [github-profile-trophy](https://github.com/ryo-ma/github-profile-trophy) to display GitHub repositories and user stats on the `/repositories/` page. + +[![Repositories Preview](readme_preview/repositories.png)](https://alshedivat.github.io/al-folio/repositories/) + +Edit the `_data/repositories.yml` and change the `github_users` and `github_repos` lists to include your own GitHub profile and repositories to the `/repositories/` page. + +You may also use the following codes for displaying this in any other pages. + +```html + +{% if site.data.repositories.github_users %} +
+ {% for user in site.data.repositories.github_users %} {% include repository/repo_user.liquid username=user %} {% endfor %} +
+{% endif %} + + +{% if site.repo_trophies.enabled %} {% for user in site.data.repositories.github_users %} {% if site.data.repositories.github_users.size > 1 %} +

{{ user }}

+{% endif %} +
+ {% include repository/repo_trophies.liquid username=user %} +
+{% endfor %} {% endif %} + + +{% if site.data.repositories.github_repos %} +
+ {% for repo in site.data.repositories.github_repos %} {% include repository/repo.liquid repository=repo %} {% endfor %} +
+{% endif %} +``` + +--- + +#### Theming + +A variety of beautiful theme colors have been selected for you to choose from. The default is purple, but you can quickly change it by editing the `--global-theme-color` variable in the `_sass/_themes.scss` file. Other color variables are listed there as well. The stock theme color options available can be found at [\_sass/\_variables.scss](_sass/_variables.scss). You can also add your own colors to this file assigning each a name for ease of use across the template. + +--- + +#### Social media previews + +**al-folio** supports preview images on social media. To enable this functionality you will need to set `serve_og_meta` to `true` in your [\_config.yml](_config.yml). Once you have done so, all your site's pages will include Open Graph data in the HTML head element. + +You will then need to configure what image to display in your site's social media previews. This can be configured on a per-page basis, by setting the `og_image` page variable. If for an individual page this variable is not set, then the theme will fall back to a site-wide `og_image` variable, configurable in your [\_config.yml](_config.yml). In both the page-specific and site-wide cases, the `og_image` variable needs to hold the URL for the image you wish to display in social media previews. + +--- + +#### Atom (RSS-like) Feed + +It generates an Atom (RSS-like) feed of your posts, useful for Atom and RSS readers. The feed is reachable simply by typing after your homepage `/feed.xml`. E.g. assuming your website mountpoint is the main folder, you can type `yourusername.github.io/feed.xml` + +--- + +#### Related posts + +By default, there will be a related posts section on the bottom of the blog posts. These are generated by selecting the `max_related` most recent posts that share at least `min_common_tags` tags with the current post. If you do not want to display related posts on a specific post, simply add `related_posts: false` to the front matter of the post. If you want to disable it for all posts, simply set `enabled` to false in the `related_blog_posts` section in [\_config.yml](_config.yml). + +--- + +#### Code quality checks + +Currently, we run some checks to ensure that the code quality and generated site are good. The checks are done using GitHub Actions and the following tools: + +- [Prettier](https://prettier.io/) - check if the formatting of the code follows the style guide +- [lychee](https://lychee.cli.rs/) - check for broken links +- [Axe](https://github.com/dequelabs/axe-core) (need to run manually) - do some accessibility testing + +We decided to keep `Axe` runs manual because fixing the issues are not straightforward and might be hard for people without web development knowledge. + +## FAQ + +For frequently asked questions, please refer to [FAQ.md](FAQ.md). + +## Contributing + +Contributions to al-folio are very welcome! Before you get started, please take a look at [the guidelines](CONTRIBUTING.md). + +If you would like to improve documentation or fix a minor inconsistency or bug, please feel free to send a PR directly to `master`. For more complex issues/bugs or feature requests, please open an issue using the appropriate template. + +### Maintainers + +Our most active contributors are welcome to join the maintainers team. If you are interested, please reach out! + + + + + + + + + + + + + +

Maruan

Rohan Deb Sarkar

Amir Pourmand

George
+ + + + + + +### All Contributors + + + + + +## Star History + + + + + + Star History Chart + + + +## License + +The theme is available as open source under the terms of the [MIT License](https://github.com/alshedivat/al-folio/blob/master/LICENSE). + +Originally, **al-folio** was based on the [\*folio theme](https://github.com/bogoli/-folio) (published by [Lia Bogoev](https://liabogoev.com) and under the MIT license). Since then, it got a full re-write of the styles and many additional cool features. diff --git a/docs/_config.yml b/docs/_config.yml index 0c2daee..bfc30f5 100644 --- a/docs/_config.yml +++ b/docs/_config.yml @@ -2,23 +2,26 @@ # Site settings # ----------------------------------------------------------------------------- -title: Prajyot Jadhav | JdeRobot x GSoC 2024 # the website title (if blank, full name will be used instead) -first_name: JdeRobot | -middle_name: -last_name: GSoC 2024 -email: prajyotj04@gmail.com -description: +title: blank # the website title (if blank, full name will be used instead) +first_name: You +middle_name: R. +last_name: Name +email: you@example.com +description: > # the ">" symbol means to ignore newlines until "footer_text:" + A simple, whitespace theme for academics. Based on [*folio](https://github.com/bogoli/-folio) design. footer_text: > - RoboticsAcademy: Migration to Gazebo Harmonic Powered by Jekyll with al-folio theme. -keywords: # add your own keywords or leave empty + Hosted by GitHub Pages. + Photos from Unsplash. +keywords: jekyll, jekyll-theme, academic-website, portfolio-website # add your own keywords or leave empty lang: en # the language of your site (for example: en, fr, cn, ru, etc.) icon: ⚛️ # the emoji used as the favicon (alternatively, provide image name in /assets/img/) -url: https://theroboticsclub.github.io # the base hostname & protocol for your site -baseurl: /gsoc2024-Prajyot_Jadhav # the subpath of your site, e.g. /blog/. Leave blank for root +url: "https://theroboticsclub.github.io" # the base hostname & protocol for your site +baseurl: "/gsoc2024-Prajyot_Jadhav" # the subpath of your site, e.g. /blog/. Leave blank for root last_updated: false # set to true if you want to display last updated in the footer impressum_path: # set to path to include impressum link in the footer, use the same path as permalink in a page, helps to conform with EU GDPR +back_to_top: true # set to false to disable the back to top button # ----------------------------------------------------------------------------- # Theme @@ -38,7 +41,7 @@ repo_trophies: # will use title and url fields # Take a look to https://github.com/jekyll/jekyll-feed for more customization -rss_icon: false +rss_icon: true # ----------------------------------------------------------------------------- # Layout @@ -46,9 +49,11 @@ rss_icon: false navbar_fixed: true footer_fixed: true +search_enabled: true +socials_in_search: true # Dimensions -max_width: 800px +max_width: 930px # TODO: add layout settings (single page vs. multi-page) @@ -72,7 +77,7 @@ dblp_url: # your DBLP profile url discord_id: # your discord id (18-digit unique numerical identifier) facebook_id: # your facebook id flickr_id: # your flickr id -github_username: Arcane-01 # your GitHub user name +github_username: # your GitHub user name gitlab_username: # your GitLab user name ieee_id: # your ieeexplore.ieee.org/author/id instagram_id: # your instagram id @@ -80,7 +85,7 @@ kaggle_id: # your kaggle id keybase_username: # your keybase user name lastfm_id: # your lastfm id lattes_id: # your ID on Lattes (Brazilian Lattes CV) -linkedin_username: prajyot-jadhav-90921a241/ # your LinkedIn user name +linkedin_username: # your LinkedIn user name mastodon_username: # your mastodon instance+username in the format instance.tld/@username medium_username: # your Medium username orcid_id: # your ORCID ID @@ -89,7 +94,7 @@ pinterest_id: # your pinterest id publons_id: # your ID on Publons quora_username: # your Quora username research_gate_profile: # your profile on ResearchGate -scholar_userid: # qc6CJjYAAAAJ # your Google Scholar ID +scholar_userid: qc6CJjYAAAAJ # your Google Scholar ID scopus_id: # your profile on Scopus semanticscholar_id: # your Semantic Scholar ID spotify_id: # your spotify id @@ -101,11 +106,12 @@ whatsapp_number: # your WhatsApp number (full phone number in international form wikidata_id: # your wikidata id wikipedia_id: # your wikipedia id (Case sensitive) work_url: # work page URL -x_username: Arcane_01 # your X handle +x_username: # your X handle youtube_id: # your youtube channel id (youtube.com/@) zotero_username: # your zotero username -contact_note: +contact_note: > + You can even add a little note about which of these is the best way to reach you. # ----------------------------------------------------------------------------- # Analytics and search engine verification @@ -124,8 +130,8 @@ bing_site_verification: # out your bing-site-verification ID (Bing Webmaster) # Blog # ----------------------------------------------------------------------------- -blog_name: # blog_name will be displayed in your blog page -blog_description: "Robotics-Academy: Migration to Gazebo Harmonic" +blog_name: al-folio # blog_name will be displayed in your blog page +blog_description: a simple whitespace theme for academics permalink: /blog/:year/:title/ lsi: true # produce an index for related posts @@ -160,8 +166,8 @@ disqus_shortname: al-folio # put your disqus shortname # If you have blog posts published on medium.com or other external sources, # you can display them in your blog by adding a link to the RSS feed. external_sources: - # - name: medium.com - # rss_url: https://medium.com/@al-folio/feed + - name: medium.com + rss_url: https://medium.com/@al-folio/feed # ----------------------------------------------------------------------------- # Collections @@ -263,7 +269,7 @@ sass: # ----------------------------------------------------------------------------- jekyll-minifier: - exclude: ["robots.txt"] + exclude: ["robots.txt", "assets/js/search/*.js"] uglifier_args: harmony: true @@ -282,10 +288,9 @@ jekyll-archives: tag: "/blog/tag/:name/" category: "/blog/category/:name/" -# display_tags: ["formatting", "images", "links", "math", "code"] # these tags will be displayed on the front page of your blog -# display_categories: ["blockquotes"] # these categories will be displayed on the front page of your blog -display_tags: [] # these tags will be displayed on the front page of your blog -display_categories: [] # these categories will be displayed on the front page of your blog +display_tags: ["formatting", "images", "links", "math", "code"] # these tags will be displayed on the front page of your blog +display_categories: ["blockquotes"] # these categories will be displayed on the front page of your blog + # ----------------------------------------------------------------------------- # Jekyll Scholar # ----------------------------------------------------------------------------- diff --git a/docs/_includes/header.liquid b/docs/_includes/header.liquid index 6a5829e..805280b 100644 --- a/docs/_includes/header.liquid +++ b/docs/_includes/header.liquid @@ -107,6 +107,14 @@ {% endif %} {% endif %} {% endfor %} + {% if site.search_enabled %} + + + {% endif %} {% if site.enable_darkmode %}
  • diff --git a/docs/_includes/scripts/back_to_top.liquid b/docs/_includes/scripts/back_to_top.liquid index 6ff79fe..c52765d 100644 --- a/docs/_includes/scripts/back_to_top.liquid +++ b/docs/_includes/scripts/back_to_top.liquid @@ -1,4 +1,6 @@ diff --git a/docs/_includes/scripts/search.liquid b/docs/_includes/scripts/search.liquid new file mode 100644 index 0000000..919e621 --- /dev/null +++ b/docs/_includes/scripts/search.liquid @@ -0,0 +1,555 @@ +{% if site.search_enabled %} + + + + +{% endif %} diff --git a/docs/_layouts/default.liquid b/docs/_layouts/default.liquid index 77b78b2..3f4af10 100644 --- a/docs/_layouts/default.liquid +++ b/docs/_layouts/default.liquid @@ -72,5 +72,6 @@ {% include scripts/imageLayouts.liquid %} {% include scripts/jekyll_tabs.liquid %} {% include scripts/back_to_top.liquid %} + {% include scripts/search.liquid %} diff --git a/docs/_layouts/post.liquid b/docs/_layouts/post.liquid index baf65f1..ccb659c 100644 --- a/docs/_layouts/post.liquid +++ b/docs/_layouts/post.liquid @@ -68,7 +68,7 @@ layout: default {{ content }} - + {% if page.citation %} {% include citation.liquid %} {% endif %} diff --git a/docs/_pages/about.md b/docs/_pages/about.md index 020af8d..7740306 100644 --- a/docs/_pages/about.md +++ b/docs/_pages/about.md @@ -1,24 +1,25 @@ --- layout: about -title: home +title: about permalink: / -subtitle: "Robotics-Academy: Migration to Gazebo Harmonic" +subtitle: Affiliations. Address. Contacts. Moto. Etc. profile: - align: left - image: prof_pic.jpeg - image_circular: true # crops the image to make it circular - more_info: + align: right + image: prof_pic.jpg + image_circular: false # crops the image to make it circular + more_info: > +

    555 your office number

    +

    123 your address street

    +

    Your City, State 12345

    -news: false # includes a list of news items -selected_papers: false # includes a list of papers marked as "selected={true}" +news: true # includes a list of news items +selected_papers: true # includes a list of papers marked as "selected={true}" social: true # includes social icons at the bottom of the page --- -Hello! I'm Prajyot Jadhav. This website is a showcase of my work for [Google Summer of Code 2024](https://summerofcode.withgoogle.com/programs/2024/projects/CgRdpsST) with [JdeRobot](https://jderobot.github.io/). I will be contributing to [Robotics-Academy](https://jderobot.github.io/RoboticsAcademy/). +Write your biography here. Tell the world about yourself. Link to your favorite [subreddit](http://reddit.com). You can put a picture in, too. The code is already in, just name your picture `prof_pic.jpg` and put it in the `img/` folder. -Robotics-Academy is a framework designed for learning robotics and computer vision through a collection of robot programming exercises. Currently, the platform offers 26 exercises and 11 prototype exercises that students can access through the RoboticsAcademy docker image (RADI), which comes pre-installed with all necessary dependencies. +Put your address / P.O. box / other info right below your picture. You can also disable any of these elements by editing `profile` property of the YAML header of your `_pages/about.md`. Edit `_bibliography/papers.bib` and Jekyll will render your [publications page](/al-folio/publications/) automatically. -The RADI is a key point of the platform and this project aims to improve it. One main component of the RADI is Gazebo. Currently, the RADI is based in Gazebo11 version, whose end of life (Sept., 2025) is getting closer. **The main goal of the project is to migrate the RADI to Gazebo Harmonic**. This migration will take form by having a couple of exercises running in ROS2 and Gazebo Harmoic with the new RADI. - -Thank you for your interest. Feel free to reach out to me if you have any questions, comments, or suggestions. \ No newline at end of file +Link to your social media connections, too. This theme is set up to use [Font Awesome icons](https://fontawesome.com/) and [Academicons](https://jpswalsh.github.io/academicons/), like the ones below. Add your Facebook, Twitter, LinkedIn, Google Scholar, or just disable all of them. diff --git a/docs/_pages/about_einstein.md b/docs/_pages/about_einstein.md new file mode 100644 index 0000000..7914a2f --- /dev/null +++ b/docs/_pages/about_einstein.md @@ -0,0 +1,5 @@ +Write your biography here. Tell the world about yourself. Link to your favorite [subreddit](http://reddit.com). You can put a picture in, too. The code is already in, just name your picture `prof_pic.jpg` and put it in the `img/` folder. + +Put your address / P.O. box / other info right below your picture. You can also disable any these elements by editing `profile` property of the YAML header of your `_pages/about.md`. Edit `_bibliography/papers.bib` and Jekyll will render your [publications page](/al-folio/publications/) automatically. + +Link to your social media connections, too. This theme is set up to use [Font Awesome icons](https://fontawesome.com/) and [Academicons](https://jpswalsh.github.io/academicons/), like the ones below. Add your Facebook, Twitter, LinkedIn, Google Scholar, or just disable all of them. diff --git a/docs/_pages/cv.md b/docs/_pages/cv.md new file mode 100644 index 0000000..ad3e26d --- /dev/null +++ b/docs/_pages/cv.md @@ -0,0 +1,11 @@ +--- +layout: cv +permalink: /cv/ +title: cv +nav: true +nav_order: 5 +cv_pdf: example_pdf.pdf +description: This is a description of the page. You can modify it in '_pages/cv.md'. You can also change or remove the top pdf download button. +toc: + sidebar: left +--- diff --git a/docs/_pages/dropdown.md b/docs/_pages/dropdown.md new file mode 100644 index 0000000..aa32f22 --- /dev/null +++ b/docs/_pages/dropdown.md @@ -0,0 +1,16 @@ +--- +layout: page +title: submenus +nav: true +nav_order: 8 +dropdown: true +children: + - title: publications + permalink: /publications/ + - title: divider + - title: projects + permalink: /projects/ + - title: divider + - title: blog + permalink: /blog/ +--- diff --git a/docs/_pages/news.md b/docs/_pages/news.md new file mode 100644 index 0000000..6223439 --- /dev/null +++ b/docs/_pages/news.md @@ -0,0 +1,7 @@ +--- +layout: page +title: news +permalink: /news/ +--- + +{% include news.liquid %} diff --git a/docs/_pages/profiles.md b/docs/_pages/profiles.md new file mode 100644 index 0000000..d7ca045 --- /dev/null +++ b/docs/_pages/profiles.md @@ -0,0 +1,28 @@ +--- +layout: profiles +permalink: /people/ +title: people +description: members of the lab or group +nav: true +nav_order: 7 + +profiles: + # if you want to include more than one profile, just replicate the following block + # and create one content file for each profile inside _pages/ + - align: right + image: prof_pic.jpg + content: about_einstein.md + image_circular: false # crops the image to make it circular + more_info: > +

    555 your office number

    +

    123 your address street

    +

    Your City, State 12345

    + - align: left + image: prof_pic.jpg + content: about_einstein.md + image_circular: false # crops the image to make it circular + more_info: > +

    555 your office number

    +

    123 your address street

    +

    Your City, State 12345

    +--- diff --git a/docs/_pages/projects.md b/docs/_pages/projects.md new file mode 100644 index 0000000..e19d655 --- /dev/null +++ b/docs/_pages/projects.md @@ -0,0 +1,65 @@ +--- +layout: page +title: projects +permalink: /projects/ +description: A growing collection of your cool projects. +nav: true +nav_order: 3 +display_categories: [work, fun] +horizontal: false +--- + + +
    +{% if site.enable_project_categories and page.display_categories %} + + {% for category in page.display_categories %} + +

    {{ category }}

    +
    + {% assign categorized_projects = site.projects | where: "category", category %} + {% assign sorted_projects = categorized_projects | sort: "importance" %} + + {% if page.horizontal %} +
    +
    + {% for project in sorted_projects %} + {% include projects_horizontal.liquid %} + {% endfor %} +
    +
    + {% else %} +
    + {% for project in sorted_projects %} + {% include projects.liquid %} + {% endfor %} +
    + {% endif %} + {% endfor %} + +{% else %} + + + +{% assign sorted_projects = site.projects | sort: "importance" %} + + + +{% if page.horizontal %} + +
    +
    + {% for project in sorted_projects %} + {% include projects_horizontal.liquid %} + {% endfor %} +
    +
    + {% else %} +
    + {% for project in sorted_projects %} + {% include projects.liquid %} + {% endfor %} +
    + {% endif %} +{% endif %} +
    diff --git a/docs/_pages/publications.md b/docs/_pages/publications.md new file mode 100644 index 0000000..d7c0ee1 --- /dev/null +++ b/docs/_pages/publications.md @@ -0,0 +1,15 @@ +--- +layout: page +permalink: /publications/ +title: publications +description: publications by categories in reversed chronological order. generated by jekyll-scholar. +nav: true +nav_order: 2 +--- + + +
    + +{% bibliography %} + +
    diff --git a/docs/_pages/repositories.md b/docs/_pages/repositories.md new file mode 100644 index 0000000..676137d --- /dev/null +++ b/docs/_pages/repositories.md @@ -0,0 +1,47 @@ +--- +layout: page +permalink: /repositories/ +title: repositories +description: Edit the `_data/repositories.yml` and change the `github_users` and `github_repos` lists to include your own GitHub profile and repositories. +nav: true +nav_order: 4 +--- + +## GitHub users + +{% if site.data.repositories.github_users %} + +
    + {% for user in site.data.repositories.github_users %} + {% include repository/repo_user.liquid username=user %} + {% endfor %} +
    + +--- + +{% if site.repo_trophies.enabled %} +{% for user in site.data.repositories.github_users %} +{% if site.data.repositories.github_users.size > 1 %} + +

    {{ user }}

    + {% endif %} +
    + {% include repository/repo_trophies.liquid username=user %} +
    + +--- + +{% endfor %} +{% endif %} +{% endif %} + +## GitHub Repositories + +{% if site.data.repositories.github_repos %} + +
    + {% for repo in site.data.repositories.github_repos %} + {% include repository/repo.liquid repository=repo %} + {% endfor %} +
    +{% endif %} diff --git a/docs/_pages/teaching.md b/docs/_pages/teaching.md new file mode 100644 index 0000000..87bb1a5 --- /dev/null +++ b/docs/_pages/teaching.md @@ -0,0 +1,12 @@ +--- +layout: page +permalink: /teaching/ +title: teaching +description: Materials for courses you taught. Replace this text with your description. +nav: true +nav_order: 6 +--- + +For now, this page is assumed to be a static description of your courses. You can convert it to a collection similar to `_projects/` so that you can have a dedicated page for each course. + +Organize your courses by years, topics, or universities, however you like! diff --git a/docs/_posts/2015-03-15-formatting-and-links.md b/docs/_posts/2015-03-15-formatting-and-links.md new file mode 100644 index 0000000..0962756 --- /dev/null +++ b/docs/_posts/2015-03-15-formatting-and-links.md @@ -0,0 +1,36 @@ +--- +layout: post +title: a post with formatting and links +date: 2015-03-15 16:40:16 +description: march & april, looking forward to summer +tags: formatting links +categories: sample-posts +--- + +Jean shorts raw denim Vice normcore, art party High Life PBR skateboard stumptown vinyl kitsch. Four loko meh 8-bit, tousled banh mi tilde forage Schlitz dreamcatcher twee 3 wolf moon. Chambray asymmetrical paleo salvia, sartorial umami four loko master cleanse drinking vinegar brunch. [Pinterest](https://www.pinterest.com) DIY authentic Schlitz, hoodie Intelligentsia butcher trust fund brunch shabby chic Kickstarter forage flexitarian. Direct trade cold-pressed meggings stumptown plaid, pop-up taxidermy. Hoodie XOXO fingerstache scenester Echo Park. Plaid ugh Wes Anderson, freegan pug selvage fanny pack leggings pickled food truck DIY irony Banksy. + +#### Hipster list + +- brunch +- fixie +- raybans +- messenger bag + +#### Check List + +- [x] Brush Teeth +- [ ] Put on socks + - [x] Put on left sock + - [ ] Put on right sock +- [x] Go to school + +Hoodie Thundercats retro, tote bag 8-bit Godard craft beer gastropub. Truffaut Tumblr taxidermy, raw denim Kickstarter sartorial dreamcatcher. Quinoa chambray slow-carb salvia readymade, bicycle rights 90's yr typewriter selfies letterpress cardigan vegan. + +
    + +Pug heirloom High Life vinyl swag, single-origin coffee four dollar toast taxidermy reprehenderit fap distillery master cleanse locavore. Est anim sapiente leggings Brooklyn ea. Thundercats locavore excepteur veniam eiusmod. Raw denim Truffaut Schlitz, migas sapiente Portland VHS twee Bushwick Marfa typewriter retro id keytar. + +> We do not grow absolutely, chronologically. We grow sometimes in one dimension, and not in another, unevenly. We grow partially. We are relative. We are mature in one realm, childish in another. +> —Anais Nin + +Fap aliqua qui, scenester pug Echo Park polaroid irony shabby chic ex cardigan church-key Odd Future accusamus. Blog stumptown sartorial squid, gastropub duis aesthetic Truffaut vero. Pinterest tilde twee, odio mumblecore jean shorts lumbersexual. diff --git a/docs/_posts/2015-05-15-images.md b/docs/_posts/2015-05-15-images.md new file mode 100644 index 0000000..61f687f --- /dev/null +++ b/docs/_posts/2015-05-15-images.md @@ -0,0 +1,49 @@ +--- +layout: post +title: a post with images +date: 2015-05-15 21:01:00 +description: this is what included images could look like +tags: formatting images +categories: sample-posts +thumbnail: assets/img/9.jpg +--- + +This is an example post with image galleries. + +
    +
    + {% include figure.liquid loading="eager" path="assets/img/9.jpg" class="img-fluid rounded z-depth-1" %} +
    +
    + {% include figure.liquid loading="eager" path="assets/img/7.jpg" class="img-fluid rounded z-depth-1" %} +
    +
    +
    + A simple, elegant caption looks good between image rows, after each row, or doesn't have to be there at all. +
    + +Images can be made zoomable. +Simply add `data-zoomable` to `` tags that you want to make zoomable. + +
    +
    + {% include figure.liquid loading="eager" path="assets/img/8.jpg" class="img-fluid rounded z-depth-1" zoomable=true %} +
    +
    + {% include figure.liquid loading="eager" path="assets/img/10.jpg" class="img-fluid rounded z-depth-1" zoomable=true %} +
    +
    + +The rest of the images in this post are all zoomable, arranged into different mini-galleries. + +
    +
    + {% include figure.liquid path="assets/img/11.jpg" class="img-fluid rounded z-depth-1" zoomable=true %} +
    +
    + {% include figure.liquid path="assets/img/12.jpg" class="img-fluid rounded z-depth-1" zoomable=true %} +
    +
    + {% include figure.liquid path="assets/img/7.jpg" class="img-fluid rounded z-depth-1" zoomable=true %} +
    +
    diff --git a/docs/_posts/2015-07-15-code.md b/docs/_posts/2015-07-15-code.md new file mode 100644 index 0000000..c721ec9 --- /dev/null +++ b/docs/_posts/2015-07-15-code.md @@ -0,0 +1,100 @@ +--- +layout: post +title: a post with code +date: 2015-07-15 15:09:00 +description: an example of a blog post with some code +tags: formatting code +categories: sample-posts +featured: true +--- + +This theme implements a built-in Jekyll feature, the use of Rouge, for syntax highlighting. +It supports more than 100 languages. +This example is in C++. +All you have to do is wrap your code in markdown code tags: + +````markdown +```c++ +code code code +``` +```` + +```c++ +int main(int argc, char const \*argv[]) +{ + string myString; + + cout << "input a string: "; + getline(cin, myString); + int length = myString.length(); + + char charArray = new char * [length]; + + charArray = myString; + for(int i = 0; i < length; ++i){ + cout << charArray[i] << " "; + } + + return 0; +} +``` + +For displaying code in a list item, you have to be aware of the indentation, as stated in this [Stackoverflow answer](https://stackoverflow.com/questions/34987908/embed-a-code-block-in-a-list-item-with-proper-indentation-in-kramdown/38090598#38090598). You must indent your code by **(3 \* bullet_indent_level)** spaces. This is because kramdown (the markdown engine used by Jekyll) indentation for the code block in lists is determined by the column number of the first non-space character after the list item marker. For example: + +````markdown +1. We can put fenced code blocks inside nested bullets, too. + + 1. Like this: + + ```c + printf("Hello, World!"); + ``` + + 2. The key is to indent your fenced block in the same line as the first character of the line. +```` + +Which displays: + +1. We can put fenced code blocks inside nested bullets, too. + + 1. Like this: + + ```c + printf("Hello, World!"); + ``` + + 2. The key is to indent your fenced block in the same line as the first character of the line. + +By default, it does not display line numbers. If you want to display line numbers for every code block, you can set `kramdown.syntax_highlighter_opts.block.line_numbers` to true in your `_config.yml` file. + +If you want to display line numbers for a specific code block, all you have to do is wrap your code in a liquid tag: + +{% raw %} +{% highlight c++ linenos %}
    code code code
    {% endhighlight %} +{% endraw %} + +The keyword `linenos` triggers display of line numbers. +Produces something like this: + +{% highlight c++ linenos %} + +int main(int argc, char const \*argv[]) +{ +string myString; + + cout << "input a string: "; + getline(cin, myString); + int length = myString.length(); + + char charArray = new char * [length]; + + charArray = myString; + for(int i = 0; i < length; ++i){ + cout << charArray[i] << " "; + } + + return 0; + +} + +{% endhighlight %} diff --git a/docs/_posts/2015-10-20-disqus-comments.md b/docs/_posts/2015-10-20-disqus-comments.md new file mode 100644 index 0000000..cf53884 --- /dev/null +++ b/docs/_posts/2015-10-20-disqus-comments.md @@ -0,0 +1,12 @@ +--- +layout: post +title: a post with disqus comments +date: 2015-10-20 11:59:00-0400 +description: an example of a blog post with disqus comments +tags: comments +categories: sample-posts external-services +disqus_comments: true +related_posts: false +--- + +This post shows how to add DISQUS comments. diff --git a/docs/_posts/2015-10-20-math.md b/docs/_posts/2015-10-20-math.md new file mode 100644 index 0000000..9ef0657 --- /dev/null +++ b/docs/_posts/2015-10-20-math.md @@ -0,0 +1,29 @@ +--- +layout: post +title: a post with math +date: 2015-10-20 11:12:00-0400 +description: an example of a blog post with some math +tags: formatting math +categories: sample-posts +related_posts: false +--- + +This theme supports rendering beautiful math in inline and display modes using [MathJax 3](https://www.mathjax.org/) engine. You just need to surround your math expression with `$$`, like `$$ E = mc^2 $$`. If you leave it inside a paragraph, it will produce an inline expression, just like $$ E = mc^2 $$. + +To use display mode, again surround your expression with `$$` and place it as a separate paragraph. Here is an example: + +$$ +\sum_{k=1}^\infty |\langle x, e_k \rangle|^2 \leq \|x\|^2 +$$ + +You can also use `\begin{equation}...\end{equation}` instead of `$$` for display mode math. +MathJax will automatically number equations: + +\begin{equation} +\label{eq:cauchy-schwarz} +\left( \sum_{k=1}^n a_k b_k \right)^2 \leq \left( \sum_{k=1}^n a_k^2 \right) \left( \sum_{k=1}^n b_k^2 \right) +\end{equation} + +and by adding `\label{...}` inside the equation environment, we can now refer to the equation using `\eqref`. + +Note that MathJax 3 is [a major re-write of MathJax](https://docs.mathjax.org/en/latest/upgrading/whats-new-3.0.html) that brought a significant improvement to the loading and rendering speed, which is now [on par with KaTeX](http://www.intmath.com/cg5/katex-mathjax-comparison.php). diff --git a/docs/_posts/2018-12-22-distill.md b/docs/_posts/2018-12-22-distill.md new file mode 100644 index 0000000..6fa2e8d --- /dev/null +++ b/docs/_posts/2018-12-22-distill.md @@ -0,0 +1,321 @@ +--- +layout: distill +title: a distill-style blog post +description: an example of a distill-style blog post and main elements +tags: distill formatting +giscus_comments: true +date: 2021-05-22 +featured: true + +authors: + - name: Albert Einstein + url: "https://en.wikipedia.org/wiki/Albert_Einstein" + affiliations: + name: IAS, Princeton + - name: Boris Podolsky + url: "https://en.wikipedia.org/wiki/Boris_Podolsky" + affiliations: + name: IAS, Princeton + - name: Nathan Rosen + url: "https://en.wikipedia.org/wiki/Nathan_Rosen" + affiliations: + name: IAS, Princeton + +bibliography: 2018-12-22-distill.bib + +# Optionally, you can add a table of contents to your post. +# NOTES: +# - make sure that TOC names match the actual section names +# for hyperlinks within the post to work correctly. +# - we may want to automate TOC generation in the future using +# jekyll-toc plugin (https://github.com/toshimaru/jekyll-toc). +toc: + - name: Equations + # if a section has subsections, you can add them as follows: + # subsections: + # - name: Example Child Subsection 1 + # - name: Example Child Subsection 2 + - name: Citations + - name: Footnotes + - name: Code Blocks + - name: Interactive Plots + - name: Layouts + - name: Other Typography? + +# Below is an example of injecting additional post-specific styles. +# If you use this post as a template, delete this _styles block. +_styles: > + .fake-img { + background: #bbb; + border: 1px solid rgba(0, 0, 0, 0.1); + box-shadow: 0 0px 4px rgba(0, 0, 0, 0.1); + margin-bottom: 12px; + } + .fake-img p { + font-family: monospace; + color: white; + text-align: left; + margin: 12px 0; + text-align: center; + font-size: 16px; + } +--- + +## Equations + +This theme supports rendering beautiful math in inline and display modes using [MathJax 3](https://www.mathjax.org/) engine. +You just need to surround your math expression with `$$`, like `$$ E = mc^2 $$`. +If you leave it inside a paragraph, it will produce an inline expression, just like $$ E = mc^2 $$. + +To use display mode, again surround your expression with `$$` and place it as a separate paragraph. +Here is an example: + +$$ +\left( \sum_{k=1}^n a_k b_k \right)^2 \leq \left( \sum_{k=1}^n a_k^2 \right) \left( \sum_{k=1}^n b_k^2 \right) +$$ + +Note that MathJax 3 is [a major re-write of MathJax](https://docs.mathjax.org/en/latest/upgrading/whats-new-3.0.html) that brought a significant improvement to the loading and rendering speed, which is now [on par with KaTeX](http://www.intmath.com/cg5/katex-mathjax-comparison.php). + +--- + +## Citations + +Citations are then used in the article body with the `` tag. +The key attribute is a reference to the id provided in the bibliography. +The key attribute can take multiple ids, separated by commas. + +The citation is presented inline like this: (a number that displays more information on hover). +If you have an appendix, a bibliography is automatically created and populated in it. + +Distill chose a numerical inline citation style to improve readability of citation dense articles and because many of the benefits of longer citations are obviated by displaying more information on hover. +However, we consider it good style to mention author last names if you discuss something at length and it fits into the flow well — the authors are human and it’s nice for them to have the community associate them with their work. + +--- + +## Footnotes + +Just wrap the text you would like to show up in a footnote in a `` tag. +The number of the footnote will be automatically generated.This will become a hoverable footnote. + +--- + +## Code Blocks + +Syntax highlighting is provided within `` tags. +An example of inline code snippets: `let x = 10;`. +For larger blocks of code, add a `block` attribute: + + + var x = 25; + function(x) { + return x * x; + } + + +**Note:** `` blocks do not look good in the dark mode. +You can always use the default code-highlight using the `highlight` liquid tag: + +{% highlight javascript %} +var x = 25; +function(x) { +return x \* x; +} +{% endhighlight %} + +--- + +## Interactive Plots + +You can add interative plots using plotly + iframes :framed_picture: + +
    + +
    + +The plot must be generated separately and saved into an HTML file. +To generate the plot that you see above, you can use the following code snippet: + +{% highlight python %} +import pandas as pd +import plotly.express as px +df = pd.read_csv( +'https://raw.githubusercontent.com/plotly/datasets/master/earthquakes-23k.csv' +) +fig = px.density_mapbox( +df, +lat='Latitude', +lon='Longitude', +z='Magnitude', +radius=10, +center=dict(lat=0, lon=180), +zoom=0, +mapbox_style="stamen-terrain", +) +fig.show() +fig.write_html('assets/plotly/demo.html') +{% endhighlight %} + +--- + +## Details boxes + +Details boxes are collapsible boxes which hide additional information from the user. They can be added with the `details` liquid tag: + +{% details Click here to know more %} +Additional details, where math $$ 2x - 1 $$ and `code` is rendered correctly. +{% enddetails %} + +--- + +## Layouts + +The main text column is referred to as the body. +It is the assumed layout of any direct descendants of the `d-article` element. + +
    +

    .l-body

    +
    + +For images you want to display a little larger, try `.l-page`: + +
    +

    .l-page

    +
    + +All of these have an outset variant if you want to poke out from the body text a little bit. +For instance: + +
    +

    .l-body-outset

    +
    + +
    +

    .l-page-outset

    +
    + +Occasionally you’ll want to use the full browser width. +For this, use `.l-screen`. +You can also inset the element a little from the edge of the browser by using the inset variant. + +
    +

    .l-screen

    +
    +
    +

    .l-screen-inset

    +
    + +The final layout is for marginalia, asides, and footnotes. +It does not interrupt the normal flow of `.l-body` sized text except on mobile screen sizes. + +
    +

    .l-gutter

    +
    + +--- + +## Other Typography? + +Emphasis, aka italics, with _asterisks_ (`*asterisks*`) or _underscores_ (`_underscores_`). + +Strong emphasis, aka bold, with **asterisks** or **underscores**. + +Combined emphasis with **asterisks and _underscores_**. + +Strikethrough uses two tildes. ~~Scratch this.~~ + +1. First ordered list item +2. Another item + ⋅⋅\* Unordered sub-list. +3. Actual numbers don't matter, just that it's a number + ⋅⋅1. Ordered sub-list +4. And another item. + +⋅⋅⋅You can have properly indented paragraphs within list items. Notice the blank line above, and the leading spaces (at least one, but we'll use three here to also align the raw Markdown). + +⋅⋅⋅To have a line break without a paragraph, you will need to use two trailing spaces.⋅⋅ +⋅⋅⋅Note that this line is separate, but within the same paragraph.⋅⋅ +⋅⋅⋅(This is contrary to the typical GFM line break behaviour, where trailing spaces are not required.) + +- Unordered list can use asterisks + +* Or minuses + +- Or pluses + +[I'm an inline-style link](https://www.google.com) + +[I'm an inline-style link with title](https://www.google.com "Google's Homepage") + +[I'm a reference-style link][Arbitrary case-insensitive reference text] + +[You can use numbers for reference-style link definitions][1] + +Or leave it empty and use the [link text itself]. + +URLs and URLs in angle brackets will automatically get turned into links. +http://www.example.com or and sometimes +example.com (but not on Github, for example). + +Some text to show that the reference links can follow later. + +[arbitrary case-insensitive reference text]: https://www.mozilla.org +[1]: http://slashdot.org +[link text itself]: http://www.reddit.com + +Here's our logo (hover to see the title text): + +Inline-style: +![alt text](https://github.com/adam-p/markdown-here/raw/master/src/common/images/icon48.png "Logo Title Text 1") + +Reference-style: +![alt text][logo] + +[logo]: https://github.com/adam-p/markdown-here/raw/master/src/common/images/icon48.png "Logo Title Text 2" + +Inline `code` has `back-ticks around` it. + +```javascript +var s = "JavaScript syntax highlighting"; +alert(s); +``` + +```python +s = "Python syntax highlighting" +print s +``` + +``` +No language indicated, so no syntax highlighting. +But let's throw in a tag. +``` + +Colons can be used to align columns. + +| Tables | Are | Cool | +| ------------- | :-----------: | ----: | +| col 3 is | right-aligned | $1600 | +| col 2 is | centered | $12 | +| zebra stripes | are neat | $1 | + +There must be at least 3 dashes separating each header cell. +The outer pipes (|) are optional, and you don't need to make the +raw Markdown line up prettily. You can also use inline Markdown. + +| Markdown | Less | Pretty | +| -------- | --------- | ---------- | +| _Still_ | `renders` | **nicely** | +| 1 | 2 | 3 | + +> Blockquotes are very handy in email to emulate reply text. +> This line is part of the same quote. + +Quote break. + +> This is a very long line that will still be quoted properly when it wraps. Oh boy let's keep writing to make sure this is long enough to actually wrap for everyone. Oh, you can _put_ **Markdown** into a blockquote. + +Here's a line for us to start with. + +This line is separated from the one above by two newlines, so it will be a _separate paragraph_. + +This line is also a separate paragraph, but... +This line is only separated by a single newline, so it's a separate line in the _same paragraph_. diff --git a/docs/_posts/2020-09-28-github-metadata.md b/docs/_posts/2020-09-28-github-metadata.md new file mode 100644 index 0000000..3adbdee --- /dev/null +++ b/docs/_posts/2020-09-28-github-metadata.md @@ -0,0 +1,39 @@ +--- +layout: post +title: a post with github metadata +date: 2020-09-28 21:01:00 +description: a quick run down on accessing github metadata. +tags: metadata +categories: sample-posts external-services +--- + +A sample blog page that demonstrates the accessing of github meta data. + +## What does Github-MetaData do? + +- Propagates the site.github namespace with repository metadata +- Setting site variables : + - site.title + - site.description + - site.url + - site.baseurl +- Accessing the metadata - duh. +- Generating edittable links. + +## Additional Reading + +- If you're recieving incorrect/missing data, you may need to perform a Github API authentication. +- Go through this README for more details on the topic. +- This page highlights all the feilds you can access with github-metadata. +
    + +## Example MetaData + +- Host Name : {{ site.github.hostname }} +- URL : {{ site.github.url }} +- BaseURL : {{ site.github.baseurl }} +- Archived : {{ site.github.archived}} +- Contributors : + {% for contributor in site.github.contributors %} + - {{ contributor.login }} + {% endfor %} diff --git a/docs/_posts/2020-09-28-twitter.md b/docs/_posts/2020-09-28-twitter.md new file mode 100644 index 0000000..e99c12d --- /dev/null +++ b/docs/_posts/2020-09-28-twitter.md @@ -0,0 +1,24 @@ +--- +layout: post +title: a post with twitter +date: 2020-09-28 11:12:00-0400 +description: an example of a blog post with twitter +tags: formatting +categories: sample-posts external-services +--- + +A sample blog page that demonstrates the inclusion of Tweets/Timelines/etc. + +# Tweet + +An example of displaying a tweet: +{% twitter https://twitter.com/rubygems/status/518821243320287232 %} + +# Timeline + +An example of pulling from a timeline: +{% twitter https://twitter.com/jekyllrb maxwidth=500 limit=3 %} + +# Additional Details + +For more details on using the plugin visit: [jekyll-twitter-plugin](https://github.com/rob-murray/jekyll-twitter-plugin) diff --git a/docs/_posts/2021-07-04-diagrams.md b/docs/_posts/2021-07-04-diagrams.md new file mode 100644 index 0000000..c85baa2 --- /dev/null +++ b/docs/_posts/2021-07-04-diagrams.md @@ -0,0 +1,34 @@ +--- +layout: post +title: a post with diagrams +date: 2021-07-04 17:39:00 +tags: formatting diagrams +description: an example of a blog post with diagrams +mermaid: + enabled: true + zoomable: true +--- + +This theme supports generating various diagrams from a text description using [mermaid](https://mermaid-js.github.io/mermaid/){:target="\_blank"}. Previously, this was done using the [jekyll-diagrams](https://github.com/zhustec/jekyll-diagrams){:target="\_blank"} plugin. For more information on this matter, see the [related issue](https://github.com/alshedivat/al-folio/issues/1609#issuecomment-1656995674). To disable the zooming feature, set `mermaid.zoomable` to `false` in this post frontmatter. + +## Mermaid + +The diagram below was generated by the following code: + +````markdown +```mermaid +sequenceDiagram + participant John + participant Alice + Alice->>John: Hello John, how are you? + John-->>Alice: Great! +``` +```` + +```mermaid +sequenceDiagram + participant John + participant Alice + Alice->>John: Hello John, how are you? + John-->>Alice: Great! +``` diff --git a/docs/_posts/2022-02-01-redirect.md b/docs/_posts/2022-02-01-redirect.md new file mode 100644 index 0000000..62be5f3 --- /dev/null +++ b/docs/_posts/2022-02-01-redirect.md @@ -0,0 +1,9 @@ +--- +layout: post +title: a post with redirect +date: 2022-02-01 17:39:00 +description: you can also redirect to assets like pdf +redirect: /assets/pdf/example_pdf.pdf +--- + +Redirecting to another page. diff --git a/docs/_posts/2022-12-10-giscus-comments.md b/docs/_posts/2022-12-10-giscus-comments.md new file mode 100644 index 0000000..72e0847 --- /dev/null +++ b/docs/_posts/2022-12-10-giscus-comments.md @@ -0,0 +1,12 @@ +--- +layout: post +title: a post with giscus comments +date: 2022-12-10 11:59:00-0400 +description: an example of a blog post with giscus comments +tags: comments +categories: sample-posts external-services +giscus_comments: true +related_posts: false +--- + +This post shows how to add GISCUS comments. diff --git a/docs/_posts/2023-03-20-table-of-contents.md b/docs/_posts/2023-03-20-table-of-contents.md new file mode 100644 index 0000000..ec91cd3 --- /dev/null +++ b/docs/_posts/2023-03-20-table-of-contents.md @@ -0,0 +1,45 @@ +--- +layout: post +title: a post with table of contents +date: 2023-03-20 11:59:00-0400 +description: an example of a blog post with table of contents +tags: formatting toc +categories: sample-posts +giscus_comments: true +related_posts: false +toc: + beginning: true +--- + +This post shows how to add a table of contents in the beginning of the post. + +## Adding a Table of Contents + +To add a table of contents to a post, simply add + +```yml +toc: + beginning: true +``` + +to the front matter of the post. The table of contents will be automatically generated from the headings in the post. + +### Example of Sub-Heading 1 + +Jean shorts raw denim Vice normcore, art party High Life PBR skateboard stumptown vinyl kitsch. Four loko meh 8-bit, tousled banh mi tilde forage Schlitz dreamcatcher twee 3 wolf moon. Chambray asymmetrical paleo salvia, sartorial umami four loko master cleanse drinking vinegar brunch. Pinterest DIY authentic Schlitz, hoodie Intelligentsia butcher trust fund brunch shabby chic Kickstarter forage flexitarian. Direct trade cold-pressed meggings stumptown plaid, pop-up taxidermy. Hoodie XOXO fingerstache scenester Echo Park. Plaid ugh Wes Anderson, freegan pug selvage fanny pack leggings pickled food truck DIY irony Banksy. + +### Example of another Sub-Heading 1 + +Jean shorts raw denim Vice normcore, art party High Life PBR skateboard stumptown vinyl kitsch. Four loko meh 8-bit, tousled banh mi tilde forage Schlitz dreamcatcher twee 3 wolf moon. Chambray asymmetrical paleo salvia, sartorial umami four loko master cleanse drinking vinegar brunch. Pinterest DIY authentic Schlitz, hoodie Intelligentsia butcher trust fund brunch shabby chic Kickstarter forage flexitarian. Direct trade cold-pressed meggings stumptown plaid, pop-up taxidermy. Hoodie XOXO fingerstache scenester Echo Park. Plaid ugh Wes Anderson, freegan pug selvage fanny pack leggings pickled food truck DIY irony Banksy. + +## Table of Contents Options + +If you want to learn more about how to customize the table of contents, you can check the [jekyll-toc](https://github.com/toshimaru/jekyll-toc) repository. + +### Example of Sub-Heading 2 + +Jean shorts raw denim Vice normcore, art party High Life PBR skateboard stumptown vinyl kitsch. Four loko meh 8-bit, tousled banh mi tilde forage Schlitz dreamcatcher twee 3 wolf moon. Chambray asymmetrical paleo salvia, sartorial umami four loko master cleanse drinking vinegar brunch. Pinterest DIY authentic Schlitz, hoodie Intelligentsia butcher trust fund brunch shabby chic Kickstarter forage flexitarian. Direct trade cold-pressed meggings stumptown plaid, pop-up taxidermy. Hoodie XOXO fingerstache scenester Echo Park. Plaid ugh Wes Anderson, freegan pug selvage fanny pack leggings pickled food truck DIY irony Banksy. + +### Example of another Sub-Heading 2 + +Jean shorts raw denim Vice normcore, art party High Life PBR skateboard stumptown vinyl kitsch. Four loko meh 8-bit, tousled banh mi tilde forage Schlitz dreamcatcher twee 3 wolf moon. Chambray asymmetrical paleo salvia, sartorial umami four loko master cleanse drinking vinegar brunch. Pinterest DIY authentic Schlitz, hoodie Intelligentsia butcher trust fund brunch shabby chic Kickstarter forage flexitarian. Direct trade cold-pressed meggings stumptown plaid, pop-up taxidermy. Hoodie XOXO fingerstache scenester Echo Park. Plaid ugh Wes Anderson, freegan pug selvage fanny pack leggings pickled food truck DIY irony Banksy. diff --git a/docs/_posts/2023-03-21-tables.md b/docs/_posts/2023-03-21-tables.md new file mode 100644 index 0000000..da1d7e8 --- /dev/null +++ b/docs/_posts/2023-03-21-tables.md @@ -0,0 +1,106 @@ +--- +layout: post +title: displaying beautiful tables with Bootstrap Tables +date: 2023-03-20 14:37:00-0400 +description: an example of how to use Bootstrap Tables +tags: formatting tables +categories: sample-posts +giscus_comments: true +related_posts: true +pretty_table: true +--- + +Using markdown to display tables is easy. Just use the following syntax: + +```markdown +| Left aligned | Center aligned | Right aligned | +| :----------- | :------------: | ------------: | +| Left 1 | center 1 | right 1 | +| Left 2 | center 2 | right 2 | +| Left 3 | center 3 | right 3 | +``` + +That will generate: + +| Left aligned | Center aligned | Right aligned | +| :----------- | :------------: | ------------: | +| Left 1 | center 1 | right 1 | +| Left 2 | center 2 | right 2 | +| Left 3 | center 3 | right 3 | + +

    + +It is also possible to use HTML to display tables. For example, the following HTML code will display a table with [Bootstrap Table](https://bootstrap-table.com/), loaded from a JSON file: + +{% raw %} + +```html + + + + + + + + +
    IDItem NameItem Price
    +``` + +{% endraw %} + + + + + + + + + +
    IDItem NameItem Price
    + +

    + +By using [Bootstrap Table](https://bootstrap-table.com/) it is possible to create pretty complex tables, with pagination, search, and more. For example, the following HTML code will display a table, loaded from a JSON file, with pagination, search, checkboxes, and header/content alignment. For more information, check the [documentation](https://examples.bootstrap-table.com/index.html). + +{% raw %} + +```html + + + + + + + + + +
    IDItem NameItem Price
    +``` + +{% endraw %} + + + + + + + + + + +
    IDItem NameItem Price
    diff --git a/docs/_posts/2023-04-24-videos.md b/docs/_posts/2023-04-24-videos.md new file mode 100644 index 0000000..d408d6b --- /dev/null +++ b/docs/_posts/2023-04-24-videos.md @@ -0,0 +1,33 @@ +--- +layout: post +title: a post with videos +date: 2023-04-24 21:01:00 +description: this is what included videos could look like +tags: formatting videos +categories: sample-posts +--- + +This is an example post with videos. It supports local video files. + +
    +
    + {% include video.liquid path="assets/video/pexels-engin-akyurt-6069112-960x540-30fps.mp4" class="img-fluid rounded z-depth-1" controls=true autoplay=true %} +
    +
    + {% include video.liquid path="assets/video/pexels-engin-akyurt-6069112-960x540-30fps.mp4" class="img-fluid rounded z-depth-1" controls=true %} +
    +
    +
    + A simple, elegant caption looks good between video rows, after each row, or doesn't have to be there at all. +
    + +It does also support embedding videos from different sources. Here are some examples: + +
    +
    + {% include video.liquid path="https://www.youtube.com/embed/jNQXAC9IVRw" class="img-fluid rounded z-depth-1" %} +
    +
    + {% include video.liquid path="https://player.vimeo.com/video/524933864?h=1ac4fd9fb4&title=0&byline=0&portrait=0" class="img-fluid rounded z-depth-1" %} +
    +
    diff --git a/docs/_posts/2023-04-25-audios.md b/docs/_posts/2023-04-25-audios.md new file mode 100644 index 0000000..1f3691c --- /dev/null +++ b/docs/_posts/2023-04-25-audios.md @@ -0,0 +1,22 @@ +--- +layout: post +title: a post with audios +date: 2023-04-25 10:25:00 +description: this is what included audios could look like +tags: formatting audios +categories: sample-posts +--- + +This is an example post with audios. It supports local audio files. + +
    +
    + {% include audio.liquid path="assets/audio/epicaly-short-113909.mp3" controls=true %} +
    +
    + {% include audio.liquid path="https://cdn.pixabay.com/download/audio/2022/06/25/audio_69a61cd6d6.mp3" controls=true %} +
    +
    +
    + A simple, elegant caption looks good between video rows, after each row, or doesn't have to be there at all. +
    diff --git a/docs/_posts/2023-04-25-sidebar-table-of-contents.md b/docs/_posts/2023-04-25-sidebar-table-of-contents.md new file mode 100644 index 0000000..2afb8fc --- /dev/null +++ b/docs/_posts/2023-04-25-sidebar-table-of-contents.md @@ -0,0 +1,47 @@ +--- +layout: post +title: a post with table of contents on a sidebar +date: 2023-04-25 10:14:00-0400 +description: an example of a blog post with table of contents on a sidebar +tags: formatting toc sidebar +categories: sample-posts +giscus_comments: true +related_posts: false +toc: + sidebar: left +--- + +This post shows how to add a table of contents as a sidebar. + +## Adding a Table of Contents + +To add a table of contents to a post as a sidebar, simply add + +```yml +toc: + sidebar: left +``` + +to the front matter of the post. The table of contents will be automatically generated from the headings in the post. If you wish to display the sidebar to the right, simply change `left` to `right`. + +### Example of Sub-Heading 1 + +Jean shorts raw denim Vice normcore, art party High Life PBR skateboard stumptown vinyl kitsch. Four loko meh 8-bit, tousled banh mi tilde forage Schlitz dreamcatcher twee 3 wolf moon. Chambray asymmetrical paleo salvia, sartorial umami four loko master cleanse drinking vinegar brunch. Pinterest DIY authentic Schlitz, hoodie Intelligentsia butcher trust fund brunch shabby chic Kickstarter forage flexitarian. Direct trade cold-pressed meggings stumptown plaid, pop-up taxidermy. Hoodie XOXO fingerstache scenester Echo Park. Plaid ugh Wes Anderson, freegan pug selvage fanny pack leggings pickled food truck DIY irony Banksy. + +### Example of another Sub-Heading 1 + +Jean shorts raw denim Vice normcore, art party High Life PBR skateboard stumptown vinyl kitsch. Four loko meh 8-bit, tousled banh mi tilde forage Schlitz dreamcatcher twee 3 wolf moon. Chambray asymmetrical paleo salvia, sartorial umami four loko master cleanse drinking vinegar brunch. Pinterest DIY authentic Schlitz, hoodie Intelligentsia butcher trust fund brunch shabby chic Kickstarter forage flexitarian. Direct trade cold-pressed meggings stumptown plaid, pop-up taxidermy. Hoodie XOXO fingerstache scenester Echo Park. Plaid ugh Wes Anderson, freegan pug selvage fanny pack leggings pickled food truck DIY irony Banksy. + +## Customizing Your Table of Contents + +{:data-toc-text="Customizing"} + +If you want to learn more about how to customize the table of contents of your sidebar, you can check the [bootstrap-toc](https://afeld.github.io/bootstrap-toc/) documentation. Notice that you can even customize the text of the heading that will be displayed on the sidebar. + +### Example of Sub-Heading 2 + +Jean shorts raw denim Vice normcore, art party High Life PBR skateboard stumptown vinyl kitsch. Four loko meh 8-bit, tousled banh mi tilde forage Schlitz dreamcatcher twee 3 wolf moon. Chambray asymmetrical paleo salvia, sartorial umami four loko master cleanse drinking vinegar brunch. Pinterest DIY authentic Schlitz, hoodie Intelligentsia butcher trust fund brunch shabby chic Kickstarter forage flexitarian. Direct trade cold-pressed meggings stumptown plaid, pop-up taxidermy. Hoodie XOXO fingerstache scenester Echo Park. Plaid ugh Wes Anderson, freegan pug selvage fanny pack leggings pickled food truck DIY irony Banksy. + +### Example of another Sub-Heading 2 + +Jean shorts raw denim Vice normcore, art party High Life PBR skateboard stumptown vinyl kitsch. Four loko meh 8-bit, tousled banh mi tilde forage Schlitz dreamcatcher twee 3 wolf moon. Chambray asymmetrical paleo salvia, sartorial umami four loko master cleanse drinking vinegar brunch. Pinterest DIY authentic Schlitz, hoodie Intelligentsia butcher trust fund brunch shabby chic Kickstarter forage flexitarian. Direct trade cold-pressed meggings stumptown plaid, pop-up taxidermy. Hoodie XOXO fingerstache scenester Echo Park. Plaid ugh Wes Anderson, freegan pug selvage fanny pack leggings pickled food truck DIY irony Banksy. diff --git a/docs/_posts/2023-05-12-custom-blockquotes.md b/docs/_posts/2023-05-12-custom-blockquotes.md new file mode 100644 index 0000000..fdaf47e --- /dev/null +++ b/docs/_posts/2023-05-12-custom-blockquotes.md @@ -0,0 +1,131 @@ +--- +layout: post +title: a post with custom blockquotes +date: 2023-05-12 15:53:00-0400 +description: an example of a blog post with custom blockquotes +tags: formatting blockquotes +categories: sample-posts +giscus_comments: true +related_posts: true +--- + +This post shows how to add custom styles for blockquotes. Based on [jekyll-gitbook](https://github.com/sighingnow/jekyll-gitbook) implementation. + +We decided to support the same custom blockquotes as in [jekyll-gitbook](https://sighingnow.github.io/jekyll-gitbook/jekyll/2022-06-30-tips_warnings_dangers.html), which are also found in a lot of other sites' styles. The styles definitions can be found on the [\_base.scss](https://github.com/alshedivat/al-folio/blob/master/_sass/_base.scss) file, more specifically: + +```scss +/* Tips, warnings, and dangers */ +.post .post-content blockquote { + &.block-tip { + border-color: var(--global-tip-block); + background-color: var(--global-tip-block-bg); + + p { + color: var(--global-tip-block-text); + } + + h1, + h2, + h3, + h4, + h5, + h6 { + color: var(--global-tip-block-title); + } + } + + &.block-warning { + border-color: var(--global-warning-block); + background-color: var(--global-warning-block-bg); + + p { + color: var(--global-warning-block-text); + } + + h1, + h2, + h3, + h4, + h5, + h6 { + color: var(--global-warning-block-title); + } + } + + &.block-danger { + border-color: var(--global-danger-block); + background-color: var(--global-danger-block-bg); + + p { + color: var(--global-danger-block-text); + } + + h1, + h2, + h3, + h4, + h5, + h6 { + color: var(--global-danger-block-title); + } + } +} +``` + +A regular blockquote can be used as following: + +```markdown +> This is a regular blockquote +> and it can be used as usual +``` + +> This is a regular blockquote +> and it can be used as usual + +These custom styles can be used by adding the specific class to the blockquote, as follows: + + + +```markdown +> ##### TIP +> +> A tip can be used when you want to give advice +> related to a certain content. +{: .block-tip } +``` + +> ##### TIP +> +> A tip can be used when you want to give advice +> related to a certain content. +{: .block-tip } + +```markdown +> ##### WARNING +> +> This is a warning, and thus should +> be used when you want to warn the user +{: .block-warning } +``` + +> ##### WARNING +> +> This is a warning, and thus should +> be used when you want to warn the user +{: .block-warning } + +```markdown +> ##### DANGER +> +> This is a danger zone, and thus should +> be used carefully +{: .block-danger } +``` + +> ##### DANGER +> +> This is a danger zone, and thus should +> be used carefully +{: .block-danger } + + diff --git a/docs/_posts/2023-07-04-jupyter-notebook.md b/docs/_posts/2023-07-04-jupyter-notebook.md new file mode 100644 index 0000000..8c1a1fc --- /dev/null +++ b/docs/_posts/2023-07-04-jupyter-notebook.md @@ -0,0 +1,45 @@ +--- +layout: post +title: a post with jupyter notebook +date: 2023-07-04 08:57:00-0400 +description: an example of a blog post with jupyter notebook +tags: formatting jupyter +categories: sample-posts +giscus_comments: true +related_posts: false +--- + +To include a jupyter notebook in a post, you can use the following code: + +{% raw %} + +```liquid +{::nomarkdown} +{% assign jupyter_path = 'assets/jupyter/blog.ipynb' | relative_url %} +{% capture notebook_exists %}{% file_exists assets/jupyter/blog.ipynb %}{% endcapture %} +{% if notebook_exists == 'true' %} + {% jupyter_notebook jupyter_path %} +{% else %} +

    Sorry, the notebook you are looking for does not exist.

    +{% endif %} +{:/nomarkdown} +``` + +{% endraw %} + +Let's break it down: this is possible thanks to [Jekyll Jupyter Notebook plugin](https://github.com/red-data-tools/jekyll-jupyter-notebook) that allows you to embed jupyter notebooks in your posts. It basically calls [`jupyter nbconvert --to html`](https://nbconvert.readthedocs.io/en/latest/usage.html#convert-html) to convert the notebook to an html page and then includes it in the post. Since [Kramdown](https://jekyllrb.com/docs/configuration/markdown/) is the default Markdown renderer for Jekyll, we need to surround the call to the plugin with the [::nomarkdown](https://kramdown.gettalong.org/syntax.html#extensions) tag so that it stops processing this part with Kramdown and outputs the content as-is. + +The plugin takes as input the path to the notebook, but it assumes the file exists. If you want to check if the file exists before calling the plugin, you can use the `file_exists` filter. This avoids getting a 404 error from the plugin and ending up displaying the main page inside of it instead. If the file does not exist, you can output a message to the user. The code displayed above outputs the following: + +{::nomarkdown} +{% assign jupyter_path = "assets/jupyter/blog.ipynb" | relative_url %} +{% capture notebook_exists %}{% file_exists assets/jupyter/blog.ipynb %}{% endcapture %} +{% if notebook_exists == "true" %} +{% jupyter_notebook jupyter_path %} +{% else %} + +

    Sorry, the notebook you are looking for does not exist.

    +{% endif %} +{:/nomarkdown} + +Note that the jupyter notebook supports both light and dark themes. diff --git a/docs/_posts/2023-07-12-post-bibliography.md b/docs/_posts/2023-07-12-post-bibliography.md new file mode 100644 index 0000000..168356c --- /dev/null +++ b/docs/_posts/2023-07-12-post-bibliography.md @@ -0,0 +1,22 @@ +--- +layout: post +title: a post with bibliography +date: 2023-07-12 09:56:00-0400 +description: an example of a blog post with bibliography +tags: formatting bib +categories: sample-posts +giscus_comments: true +related_posts: false +related_publications: true +--- + +This post shows how to add bibliography to simple blog posts. We support every citation style that [jekyll-scholar](https://github.com/inukshuk/jekyll-scholar) does. That means simple citation like {% cite einstein1950meaning %}, multiple citations like {% cite einstein1950meaning einstein1905movement %}, long references like {% reference einstein1905movement %} or also quotes: + +{% quote einstein1905electrodynamics %} +Lorem ipsum dolor sit amet, consectetur adipisicing elit, +sed do eiusmod tempor. + +Lorem ipsum dolor sit amet, consectetur adipisicing. +{% endquote %} + +If you would like something more academic, check the [distill style post]({% post_url 2018-12-22-distill %}). diff --git a/docs/_posts/2023-12-12-tikzjax.md b/docs/_posts/2023-12-12-tikzjax.md new file mode 100644 index 0000000..a0df331 --- /dev/null +++ b/docs/_posts/2023-12-12-tikzjax.md @@ -0,0 +1,19 @@ +--- +layout: post +title: a post with TikZJax +date: 2023-12-12 22:25:00 +description: this is what included TikZ code could look like +tags: formatting diagrams +categories: sample-posts +tikzjax: true +--- + +This is an example post with TikZ code. TikZJax converts script tags (containing TikZ code) into SVGs. + + diff --git a/docs/_posts/2024-01-26-chartjs.md b/docs/_posts/2024-01-26-chartjs.md new file mode 100644 index 0000000..210557d --- /dev/null +++ b/docs/_posts/2024-01-26-chartjs.md @@ -0,0 +1,188 @@ +--- +layout: post +title: a post with chart.js +date: 2024-01-26 01:04:00 +description: this is what included chart.js code could look like +tags: formatting charts +categories: sample-posts +chart: + chartjs: true +--- + +This is an example post with some [chart.js](https://www.chartjs.org/) code. + +````markdown +```chartjs +{ + "type": "line", + "data": { + "labels": [ + "January", + "February", + "March", + "April", + "May", + "June", + "July" + ], + "datasets": [ + { + "label": "# of bugs", + "fill": false, + "lineTension": 0.1, + "backgroundColor": "rgba(75,192,192,0.4)", + "borderColor": "rgba(75,192,192,1)", + "borderCapStyle": "butt", + "borderDash": [], + "borderDashOffset": 0, + "borderJoinStyle": "miter", + "pointBorderColor": "rgba(75,192,192,1)", + "pointBackgroundColor": "#fff", + "pointBorderWidth": 1, + "pointHoverRadius": 5, + "pointHoverBackgroundColor": "rgba(75,192,192,1)", + "pointHoverBorderColor": "rgba(220,220,220,1)", + "pointHoverBorderWidth": 2, + "pointRadius": 1, + "pointHitRadius": 10, + "data": [ + 65, + 59, + 80, + 81, + 56, + 55, + 40 + ], + "spanGaps": false + } + ] + }, + "options": {} +} +``` +```` + +This is how it looks like: + +```chartjs +{ + "type": "line", + "data": { + "labels": [ + "January", + "February", + "March", + "April", + "May", + "June", + "July" + ], + "datasets": [ + { + "label": "# of bugs", + "fill": false, + "lineTension": 0.1, + "backgroundColor": "rgba(75,192,192,0.4)", + "borderColor": "rgba(75,192,192,1)", + "borderCapStyle": "butt", + "borderDash": [], + "borderDashOffset": 0, + "borderJoinStyle": "miter", + "pointBorderColor": "rgba(75,192,192,1)", + "pointBackgroundColor": "#fff", + "pointBorderWidth": 1, + "pointHoverRadius": 5, + "pointHoverBackgroundColor": "rgba(75,192,192,1)", + "pointHoverBorderColor": "rgba(220,220,220,1)", + "pointHoverBorderWidth": 2, + "pointRadius": 1, + "pointHitRadius": 10, + "data": [ + 65, + 59, + 80, + 81, + 56, + 55, + 40 + ], + "spanGaps": false + } + ] + }, + "options": {} +} +``` + +Also another example chart. + +````markdown +```chartjs +{ + "type": "doughnut", + "data": { + "labels": [ + "Red", + "Blue", + "Yellow" + ], + "datasets": [ + { + "data": [ + 300, + 50, + 100 + ], + "backgroundColor": [ + "#FF6384", + "#36A2EB", + "#FFCE56" + ], + "hoverBackgroundColor": [ + "#FF6384", + "#36A2EB", + "#FFCE56" + ] + } + ] + }, + "options": {} +} +``` +```` + +Which generates: + +```chartjs +{ + "type": "doughnut", + "data": { + "labels": [ + "Red", + "Blue", + "Yellow" + ], + "datasets": [ + { + "data": [ + 300, + 50, + 100 + ], + "backgroundColor": [ + "#FF6384", + "#36A2EB", + "#FFCE56" + ], + "hoverBackgroundColor": [ + "#FF6384", + "#36A2EB", + "#FFCE56" + ] + } + ] + }, + "options": {} +} +``` diff --git a/docs/_posts/2024-01-26-echarts.md b/docs/_posts/2024-01-26-echarts.md new file mode 100644 index 0000000..b496288 --- /dev/null +++ b/docs/_posts/2024-01-26-echarts.md @@ -0,0 +1,68 @@ +--- +layout: post +title: a post with echarts +date: 2024-01-26 16:03:00 +description: this is what included echarts code could look like +tags: formatting charts +categories: sample-posts +chart: + echarts: true +--- + +This is an example post with some [echarts](https://echarts.apache.org/) code. + +````markdown +```echarts +{ + "title": { + "text": "ECharts Getting Started Example" + }, + "responsive": true, + "tooltip": {}, + "legend": { + "top": "30px", + "data": ["sales"] + }, + "xAxis": { + "data": ["Shirts", "Cardigans", "Chiffons", "Pants", "Heels", "Socks"] + }, + "yAxis": {}, + "series": [ + { + "name": "sales", + "type": "bar", + "data": [5, 20, 36, 10, 10, 20] + } + ] +} +``` +```` + +Which generates: + +```echarts +{ + "title": { + "text": "ECharts Getting Started Example" + }, + "responsive": true, + "tooltip": {}, + "legend": { + "top": "30px", + "data": ["sales"] + }, + "xAxis": { + "data": ["Shirts", "Cardigans", "Chiffons", "Pants", "Heels", "Socks"] + }, + "yAxis": {}, + "series": [ + { + "name": "sales", + "type": "bar", + "data": [5, 20, 36, 10, 10, 20] + } + ] +} +``` + +Note that this library offer support for both light and dark themes. You can switch between them using the theme switcher in the top right corner of the page. diff --git a/docs/_posts/2024-01-26-geojson-map.md b/docs/_posts/2024-01-26-geojson-map.md new file mode 100644 index 0000000..6909aee --- /dev/null +++ b/docs/_posts/2024-01-26-geojson-map.md @@ -0,0 +1,93 @@ +--- +layout: post +title: a post with geojson +date: 2024-01-26 17:57:00 +description: this is what included geojson code could look like +tags: formatting charts maps +categories: sample-posts +map: true +--- + +This is an example post with some [geojson](https://geojson.org/) code. The support is provided thanks to [Leaflet](https://leafletjs.com/). To create your own visualization, go to [geojson.io](https://geojson.io/). + +````markdown +```geojson +{ + "type": "FeatureCollection", + "features": [ + { + "type": "Feature", + "properties": {}, + "geometry": { + "coordinates": [ + [ + [ + -60.11363029935569, + -2.904625022183211 + ], + [ + -60.11363029935569, + -3.162613728707967 + ], + [ + -59.820894493858034, + -3.162613728707967 + ], + [ + -59.820894493858034, + -2.904625022183211 + ], + [ + -60.11363029935569, + -2.904625022183211 + ] + ] + ], + "type": "Polygon" + } + } + ] +} +``` +```` + +Which generates: + +```geojson +{ + "type": "FeatureCollection", + "features": [ + { + "type": "Feature", + "properties": {}, + "geometry": { + "coordinates": [ + [ + [ + -60.11363029935569, + -2.904625022183211 + ], + [ + -60.11363029935569, + -3.162613728707967 + ], + [ + -59.820894493858034, + -3.162613728707967 + ], + [ + -59.820894493858034, + -2.904625022183211 + ], + [ + -60.11363029935569, + -2.904625022183211 + ] + ] + ], + "type": "Polygon" + } + } + ] +} +``` diff --git a/docs/_posts/2024-01-27-advanced-images.md b/docs/_posts/2024-01-27-advanced-images.md new file mode 100644 index 0000000..3baa160 --- /dev/null +++ b/docs/_posts/2024-01-27-advanced-images.md @@ -0,0 +1,35 @@ +--- +layout: post +title: a post with advanced image components +date: 2024-01-27 11:46:00 +description: this is what advanced image components could look like +tags: formatting images +categories: sample-posts +thumbnail: assets/img/9.jpg +images: + compare: true + slider: true +--- + +This is an example post with advanced image components. + +## Image Slider + +This is a simple image slider. It uses the [Swiper](https://swiperjs.com/) library. Check the [examples page](https://swiperjs.com/demos) for more information of what you can achieve with it. + + + {% include figure.liquid loading="eager" path="assets/img/9.jpg" class="img-fluid rounded z-depth-1" %} + {% include figure.liquid loading="eager" path="assets/img/7.jpg" class="img-fluid rounded z-depth-1" %} + {% include figure.liquid loading="eager" path="assets/img/8.jpg" class="img-fluid rounded z-depth-1" %} + {% include figure.liquid loading="eager" path="assets/img/10.jpg" class="img-fluid rounded z-depth-1" %} + {% include figure.liquid loading="eager" path="assets/img/12.jpg" class="img-fluid rounded z-depth-1" %} + + +## Image Comparison Slider + +This is a simple image comparison slider. It uses the [img-comparison-slider](https://img-comparison-slider.sneas.io/) library. Check the [examples page](https://img-comparison-slider.sneas.io/examples.html) for more information of what you can achieve with it. + + + {% include figure.liquid path="assets/img/prof_pic.jpg" class="img-fluid rounded z-depth-1" slot="first" %} + {% include figure.liquid path="assets/img/prof_pic_color.png" class="img-fluid rounded z-depth-1" slot="second" %} + diff --git a/docs/_posts/2024-01-27-code-diff.md b/docs/_posts/2024-01-27-code-diff.md new file mode 100644 index 0000000..6ec06d5 --- /dev/null +++ b/docs/_posts/2024-01-27-code-diff.md @@ -0,0 +1,473 @@ +--- +layout: post +title: a post with code diff +date: 2024-01-27 19:22:00 +description: this is how you can display code diffs +tags: formatting code +categories: sample-posts +code_diff: true +--- + +You can display diff code by using the regular markdown syntax: + +````markdown +```diff +diff --git a/sample.js b/sample.js +index 0000001..0ddf2ba +--- a/sample.js ++++ b/sample.js +@@ -1 +1 @@ +-console.log("Hello World!") ++console.log("Hello from Diff2Html!") +``` +```` + +Which generates: + +```diff +diff --git a/sample.js b/sample.js +index 0000001..0ddf2ba +--- a/sample.js ++++ b/sample.js +@@ -1 +1 @@ +-console.log("Hello World!") ++console.log("Hello from Diff2Html!") +``` + +But this is difficult to read, specially if you have a large diff. You can use [diff2html](https://diff2html.xyz/) to display a more readable version of the diff. For this, just use `diff2html` instead of `diff` for the code block language: + +````markdown +```diff2html +diff --git a/sample.js b/sample.js +index 0000001..0ddf2ba +--- a/sample.js ++++ b/sample.js +@@ -1 +1 @@ +-console.log("Hello World!") ++console.log("Hello from Diff2Html!") +``` +```` + +If we use a longer example, for example [this commit from diff2html](https://github.com/rtfpessoa/diff2html/commit/c2c253d3e3f8b8b267f551e659f72b44ca2ac927), it will generate the following output: + +```diff2html +From 2aaae31cc2a37bfff83430c2c914b140bee59b6a Mon Sep 17 00:00:00 2001 +From: Rodrigo Fernandes +Date: Sun, 9 Oct 2016 16:41:54 +0100 +Subject: [PATCH 1/2] Initial template override support + +--- + scripts/hulk.js | 4 ++-- + src/diff2html.js | 3 +-- + src/file-list-printer.js | 11 ++++++++--- + src/hoganjs-utils.js | 29 +++++++++++++++++------------ + src/html-printer.js | 6 ++++++ + src/line-by-line-printer.js | 6 +++++- + src/side-by-side-printer.js | 6 +++++- + test/file-list-printer-tests.js | 2 +- + test/hogan-cache-tests.js | 18 +++++++++++++++--- + test/line-by-line-tests.js | 3 +-- + test/side-by-side-printer-tests.js | 3 +-- + 11 files changed, 62 insertions(+), 29 deletions(-) + +diff --git a/scripts/hulk.js b/scripts/hulk.js +index 5a793c18..a4b1a4d5 100755 +--- a/scripts/hulk.js ++++ b/scripts/hulk.js +@@ -173,11 +173,11 @@ function namespace(name) { + // write a template foreach file that matches template extension + templates = extractFiles(options.argv.remain) + .map(function(file) { +- var openedFile = fs.readFileSync(file, 'utf-8'); ++ var openedFile = fs.readFileSync(file, 'utf-8').trim(); + var name; + if (!openedFile) return; + name = namespace(path.basename(file).replace(/\..*$/, '')); +- openedFile = removeByteOrderMark(openedFile.trim()); ++ openedFile = removeByteOrderMark(openedFile); + openedFile = wrap(file, name, openedFile); + if (!options.outputdir) return openedFile; + fs.writeFileSync(path.join(options.outputdir, name + '.js') +diff --git a/src/diff2html.js b/src/diff2html.js +index 21b0119e..64e138f5 100644 +--- a/src/diff2html.js ++++ b/src/diff2html.js +@@ -7,7 +7,6 @@ + + (function() { + var diffParser = require('./diff-parser.js').DiffParser; +- var fileLister = require('./file-list-printer.js').FileListPrinter; + var htmlPrinter = require('./html-printer.js').HtmlPrinter; + + function Diff2Html() { +@@ -43,7 +42,7 @@ + + var fileList = ''; + if (configOrEmpty.showFiles === true) { +- fileList = fileLister.generateFileList(diffJson, configOrEmpty); ++ fileList = htmlPrinter.generateFileListSummary(diffJson, configOrEmpty); + } + + var diffOutput = ''; +diff --git a/src/file-list-printer.js b/src/file-list-printer.js +index e408d9b2..1e0a2c61 100644 +--- a/src/file-list-printer.js ++++ b/src/file-list-printer.js +@@ -8,11 +8,16 @@ + (function() { + var printerUtils = require('./printer-utils.js').PrinterUtils; + +- var hoganUtils = require('./hoganjs-utils.js').HoganJsUtils; ++ var hoganUtils; ++ + var baseTemplatesPath = 'file-summary'; + var iconsBaseTemplatesPath = 'icon'; + +- function FileListPrinter() { ++ function FileListPrinter(config) { ++ this.config = config; ++ ++ var HoganJsUtils = require('./hoganjs-utils.js').HoganJsUtils; ++ hoganUtils = new HoganJsUtils(config); + } + + FileListPrinter.prototype.generateFileList = function(diffFiles) { +@@ -38,5 +43,5 @@ + }); + }; + +- module.exports.FileListPrinter = new FileListPrinter(); ++ module.exports.FileListPrinter = FileListPrinter; + })(); +diff --git a/src/hoganjs-utils.js b/src/hoganjs-utils.js +index 9949e5fa..0dda08d7 100644 +--- a/src/hoganjs-utils.js ++++ b/src/hoganjs-utils.js +@@ -8,18 +8,19 @@ + (function() { + var fs = require('fs'); + var path = require('path'); +- + var hogan = require('hogan.js'); + + var hoganTemplates = require('./templates/diff2html-templates.js'); + +- var templatesPath = path.resolve(__dirname, 'templates'); ++ var extraTemplates; + +- function HoganJsUtils() { ++ function HoganJsUtils(configuration) { ++ this.config = configuration || {}; ++ extraTemplates = this.config.templates || {}; + } + +- HoganJsUtils.prototype.render = function(namespace, view, params, configuration) { +- var template = this.template(namespace, view, configuration); ++ HoganJsUtils.prototype.render = function(namespace, view, params) { ++ var template = this.template(namespace, view); + if (template) { + return template.render(params); + } +@@ -27,17 +28,16 @@ + return null; + }; + +- HoganJsUtils.prototype.template = function(namespace, view, configuration) { +- var config = configuration || {}; ++ HoganJsUtils.prototype.template = function(namespace, view) { + var templateKey = this._templateKey(namespace, view); + +- return this._getTemplate(templateKey, config); ++ return this._getTemplate(templateKey); + }; + +- HoganJsUtils.prototype._getTemplate = function(templateKey, config) { ++ HoganJsUtils.prototype._getTemplate = function(templateKey) { + var template; + +- if (!config.noCache) { ++ if (!this.config.noCache) { + template = this._readFromCache(templateKey); + } + +@@ -53,6 +53,7 @@ + + try { + if (fs.readFileSync) { ++ var templatesPath = path.resolve(__dirname, 'templates'); + var templatePath = path.join(templatesPath, templateKey); + var templateContent = fs.readFileSync(templatePath + '.mustache', 'utf8'); + template = hogan.compile(templateContent); +@@ -66,12 +67,16 @@ + }; + + HoganJsUtils.prototype._readFromCache = function(templateKey) { +- return hoganTemplates[templateKey]; ++ return extraTemplates[templateKey] || hoganTemplates[templateKey]; + }; + + HoganJsUtils.prototype._templateKey = function(namespace, view) { + return namespace + '-' + view; + }; + +- module.exports.HoganJsUtils = new HoganJsUtils(); ++ HoganJsUtils.prototype.compile = function(templateStr) { ++ return hogan.compile(templateStr); ++ }; ++ ++ module.exports.HoganJsUtils = HoganJsUtils; + })(); +diff --git a/src/html-printer.js b/src/html-printer.js +index 585d5b66..13f83047 100644 +--- a/src/html-printer.js ++++ b/src/html-printer.js +@@ -8,6 +8,7 @@ + (function() { + var LineByLinePrinter = require('./line-by-line-printer.js').LineByLinePrinter; + var SideBySidePrinter = require('./side-by-side-printer.js').SideBySidePrinter; ++ var FileListPrinter = require('./file-list-printer.js').FileListPrinter; + + function HtmlPrinter() { + } +@@ -22,5 +23,10 @@ + return sideBySidePrinter.generateSideBySideJsonHtml(diffFiles); + }; + ++ HtmlPrinter.prototype.generateFileListSummary = function(diffJson, config) { ++ var fileListPrinter = new FileListPrinter(config); ++ return fileListPrinter.generateFileList(diffJson); ++ }; ++ + module.exports.HtmlPrinter = new HtmlPrinter(); + })(); +diff --git a/src/line-by-line-printer.js b/src/line-by-line-printer.js +index b07eb53c..d230bedd 100644 +--- a/src/line-by-line-printer.js ++++ b/src/line-by-line-printer.js +@@ -11,7 +11,8 @@ + var utils = require('./utils.js').Utils; + var Rematch = require('./rematch.js').Rematch; + +- var hoganUtils = require('./hoganjs-utils.js').HoganJsUtils; ++ var hoganUtils; ++ + var genericTemplatesPath = 'generic'; + var baseTemplatesPath = 'line-by-line'; + var iconsBaseTemplatesPath = 'icon'; +@@ -19,6 +20,9 @@ + + function LineByLinePrinter(config) { + this.config = config; ++ ++ var HoganJsUtils = require('./hoganjs-utils.js').HoganJsUtils; ++ hoganUtils = new HoganJsUtils(config); + } + + LineByLinePrinter.prototype.makeFileDiffHtml = function(file, diffs) { +diff --git a/src/side-by-side-printer.js b/src/side-by-side-printer.js +index bbf1dc8d..5e3033b3 100644 +--- a/src/side-by-side-printer.js ++++ b/src/side-by-side-printer.js +@@ -11,7 +11,8 @@ + var utils = require('./utils.js').Utils; + var Rematch = require('./rematch.js').Rematch; + +- var hoganUtils = require('./hoganjs-utils.js').HoganJsUtils; ++ var hoganUtils; ++ + var genericTemplatesPath = 'generic'; + var baseTemplatesPath = 'side-by-side'; + var iconsBaseTemplatesPath = 'icon'; +@@ -26,6 +27,9 @@ + + function SideBySidePrinter(config) { + this.config = config; ++ ++ var HoganJsUtils = require('./hoganjs-utils.js').HoganJsUtils; ++ hoganUtils = new HoganJsUtils(config); + } + + SideBySidePrinter.prototype.makeDiffHtml = function(file, diffs) { +diff --git a/test/file-list-printer-tests.js b/test/file-list-printer-tests.js +index a502a46f..60ea3208 100644 +--- a/test/file-list-printer-tests.js ++++ b/test/file-list-printer-tests.js +@@ -1,6 +1,6 @@ + var assert = require('assert'); + +-var fileListPrinter = require('../src/file-list-printer.js').FileListPrinter; ++var fileListPrinter = new (require('../src/file-list-printer.js').FileListPrinter)(); + + describe('FileListPrinter', function() { + describe('generateFileList', function() { +diff --git a/test/hogan-cache-tests.js b/test/hogan-cache-tests.js +index 190bf6f8..3bb754ac 100644 +--- a/test/hogan-cache-tests.js ++++ b/test/hogan-cache-tests.js +@@ -1,6 +1,6 @@ + var assert = require('assert'); + +-var HoganJsUtils = require('../src/hoganjs-utils.js').HoganJsUtils; ++var HoganJsUtils = new (require('../src/hoganjs-utils.js').HoganJsUtils)(); + var diffParser = require('../src/diff-parser.js').DiffParser; + + describe('HoganJsUtils', function() { +@@ -21,16 +21,28 @@ describe('HoganJsUtils', function() { + }); + assert.equal(emptyDiffHtml, result); + }); ++ + it('should render view without cache', function() { + var result = HoganJsUtils.render('generic', 'empty-diff', { + contentClass: 'd2h-code-line', + diffParser: diffParser + }, {noCache: true}); +- assert.equal(emptyDiffHtml + '\n', result); ++ assert.equal(emptyDiffHtml, result); + }); ++ + it('should return null if template is missing', function() { +- var result = HoganJsUtils.render('generic', 'missing-template', {}, {noCache: true}); ++ var hoganUtils = new (require('../src/hoganjs-utils.js').HoganJsUtils)({noCache: true}); ++ var result = hoganUtils.render('generic', 'missing-template', {}); + assert.equal(null, result); + }); ++ ++ it('should allow templates to be overridden', function() { ++ var emptyDiffTemplate = HoganJsUtils.compile('

    {{myName}}

    '); ++ ++ var config = {templates: {'generic-empty-diff': emptyDiffTemplate}}; ++ var hoganUtils = new (require('../src/hoganjs-utils.js').HoganJsUtils)(config); ++ var result = hoganUtils.render('generic', 'empty-diff', {myName: 'Rodrigo Fernandes'}); ++ assert.equal('

    Rodrigo Fernandes

    ', result); ++ }); + }); + }); +diff --git a/test/line-by-line-tests.js b/test/line-by-line-tests.js +index 1cd92073..8869b3df 100644 +--- a/test/line-by-line-tests.js ++++ b/test/line-by-line-tests.js +@@ -14,7 +14,7 @@ describe('LineByLinePrinter', function() { + ' File without changes\n' + + ' \n' + + ' \n' + +- '\n'; ++ ''; + + assert.equal(expected, fileHtml); + }); +@@ -422,7 +422,6 @@ describe('LineByLinePrinter', function() { + ' \n' + + ' \n' + + '\n' + +- '\n' + + ' \n' + + ' \n' + + ' \n' + +diff --git a/test/side-by-side-printer-tests.js b/test/side-by-side-printer-tests.js +index 76625f8e..771daaa5 100644 +--- a/test/side-by-side-printer-tests.js ++++ b/test/side-by-side-printer-tests.js +@@ -14,7 +14,7 @@ describe('SideBySidePrinter', function() { + ' File without changes\n' + + ' \n' + + ' \n' + +- '\n'; ++ ''; + + assert.equal(expectedRight, fileHtml.right); + assert.equal(expectedLeft, fileHtml.left); +@@ -324,7 +324,6 @@ describe('SideBySidePrinter', function() { + ' \n' + + ' \n' + + '\n' + +- '\n' + + ' \n' + + ' \n' + + ' \n' + + +From f3cadb96677d0eb82fc2752dc3ffbf35ca9b5bdb Mon Sep 17 00:00:00 2001 +From: Rodrigo Fernandes +Date: Sat, 15 Oct 2016 13:21:22 +0100 +Subject: [PATCH 2/2] Allow uncompiled templates + +--- + README.md | 3 +++ + src/hoganjs-utils.js | 7 +++++++ + test/hogan-cache-tests.js | 24 +++++++++++++++++++++++- + 3 files changed, 33 insertions(+), 1 deletion(-) + +diff --git a/README.md b/README.md +index 132c8a28..46909f25 100644 +--- a/README.md ++++ b/README.md +@@ -98,6 +98,9 @@ The HTML output accepts a Javascript object with configuration. Possible options + - `synchronisedScroll`: scroll both panes in side-by-side mode: `true` or `false`, default is `false` + - `matchWordsThreshold`: similarity threshold for word matching, default is 0.25 + - `matchingMaxComparisons`: perform at most this much comparisons for line matching a block of changes, default is `2500` ++ - `templates`: object with previously compiled templates to replace parts of the html ++ - `rawTemplates`: object with raw not compiled templates to replace parts of the html ++ > For more information regarding the possible templates look into [src/templates](https://github.com/rtfpessoa/diff2html/tree/master/src/templates) + + ## Diff2HtmlUI Helper + +diff --git a/src/hoganjs-utils.js b/src/hoganjs-utils.js +index 0dda08d7..b2e9c275 100644 +--- a/src/hoganjs-utils.js ++++ b/src/hoganjs-utils.js +@@ -17,6 +17,13 @@ + function HoganJsUtils(configuration) { + this.config = configuration || {}; + extraTemplates = this.config.templates || {}; ++ ++ var rawTemplates = this.config.rawTemplates || {}; ++ for (var templateName in rawTemplates) { ++ if (rawTemplates.hasOwnProperty(templateName)) { ++ if (!extraTemplates[templateName]) extraTemplates[templateName] = this.compile(rawTemplates[templateName]); ++ } ++ } + } + + HoganJsUtils.prototype.render = function(namespace, view, params) { +diff --git a/test/hogan-cache-tests.js b/test/hogan-cache-tests.js +index 3bb754ac..a34839c0 100644 +--- a/test/hogan-cache-tests.js ++++ b/test/hogan-cache-tests.js +@@ -36,7 +36,7 @@ describe('HoganJsUtils', function() { + assert.equal(null, result); + }); + +- it('should allow templates to be overridden', function() { ++ it('should allow templates to be overridden with compiled templates', function() { + var emptyDiffTemplate = HoganJsUtils.compile('

    {{myName}}

    '); + + var config = {templates: {'generic-empty-diff': emptyDiffTemplate}}; +@@ -44,5 +44,27 @@ describe('HoganJsUtils', function() { + var result = hoganUtils.render('generic', 'empty-diff', {myName: 'Rodrigo Fernandes'}); + assert.equal('

    Rodrigo Fernandes

    ', result); + }); ++ ++ it('should allow templates to be overridden with uncompiled templates', function() { ++ var emptyDiffTemplate = '

    {{myName}}

    '; ++ ++ var config = {rawTemplates: {'generic-empty-diff': emptyDiffTemplate}}; ++ var hoganUtils = new (require('../src/hoganjs-utils.js').HoganJsUtils)(config); ++ var result = hoganUtils.render('generic', 'empty-diff', {myName: 'Rodrigo Fernandes'}); ++ assert.equal('

    Rodrigo Fernandes

    ', result); ++ }); ++ ++ it('should allow templates to be overridden giving priority to compiled templates', function() { ++ var emptyDiffTemplate = HoganJsUtils.compile('

    {{myName}}

    '); ++ var emptyDiffTemplateUncompiled = '

    Not used!

    '; ++ ++ var config = { ++ templates: {'generic-empty-diff': emptyDiffTemplate}, ++ rawTemplates: {'generic-empty-diff': emptyDiffTemplateUncompiled} ++ }; ++ var hoganUtils = new (require('../src/hoganjs-utils.js').HoganJsUtils)(config); ++ var result = hoganUtils.render('generic', 'empty-diff', {myName: 'Rodrigo Fernandes'}); ++ assert.equal('

    Rodrigo Fernandes

    ', result); ++ }); + }); + }); +``` diff --git a/docs/_posts/2024-01-27-vega-lite.md b/docs/_posts/2024-01-27-vega-lite.md new file mode 100644 index 0000000..099eb88 --- /dev/null +++ b/docs/_posts/2024-01-27-vega-lite.md @@ -0,0 +1,105 @@ +--- +layout: post +title: a post with vega lite +date: 2024-01-27 00:20:00 +last_updated: 2024-04-14 04:30:00 +description: this is what included vega lite code could look like +tags: formatting charts +categories: sample-posts +chart: + vega_lite: true +--- + +This is an example post with some [vega lite](https://vega.github.io/vega-lite/) code. + +````markdown +```vega_lite +{ + "$schema": "https://vega.github.io/schema/vega-lite/v5.json", + "description": "A dot plot showing each movie in the database, and the difference from the average movie rating. The display is sorted by year to visualize everything in sequential order. The graph is for all Movies before 2019.", + "data": { + "url": "https://raw.githubusercontent.com/vega/vega/main/docs/data/movies.json" + }, + "transform": [ + {"filter": "datum['IMDB Rating'] != null"}, + {"filter": {"timeUnit": "year", "field": "Release Date", "range": [null, 2019]}}, + { + "joinaggregate": [{ + "op": "mean", + "field": "IMDB Rating", + "as": "AverageRating" + }] + }, + { + "calculate": "datum['IMDB Rating'] - datum.AverageRating", + "as": "RatingDelta" + } + ], + "mark": "point", + "encoding": { + "x": { + "field": "Release Date", + "type": "temporal" + }, + "y": { + "field": "RatingDelta", + "type": "quantitative", + "title": "Rating Delta" + }, + "color": { + "field": "RatingDelta", + "type": "quantitative", + "scale": {"domainMid": 0}, + "title": "Rating Delta" + } + } +} +``` +```` + +Which generates: + +```vega_lite +{ + "$schema": "https://vega.github.io/schema/vega-lite/v5.json", + "description": "A dot plot showing each movie in the database, and the difference from the average movie rating. The display is sorted by year to visualize everything in sequential order. The graph is for all Movies before 2019.", + "data": { + "url": "https://raw.githubusercontent.com/vega/vega/main/docs/data/movies.json" + }, + "transform": [ + {"filter": "datum['IMDB Rating'] != null"}, + {"filter": {"timeUnit": "year", "field": "Release Date", "range": [null, 2019]}}, + { + "joinaggregate": [{ + "op": "mean", + "field": "IMDB Rating", + "as": "AverageRating" + }] + }, + { + "calculate": "datum['IMDB Rating'] - datum.AverageRating", + "as": "RatingDelta" + } + ], + "mark": "point", + "encoding": { + "x": { + "field": "Release Date", + "type": "temporal" + }, + "y": { + "field": "RatingDelta", + "type": "quantitative", + "title": "Rating Delta" + }, + "color": { + "field": "RatingDelta", + "type": "quantitative", + "scale": {"domainMid": 0}, + "title": "Rating Delta" + } + } +} +``` + +This plot supports both light and dark themes. diff --git a/docs/_posts/2024-04-15-pseudocode.md b/docs/_posts/2024-04-15-pseudocode.md new file mode 100644 index 0000000..d7ff18b --- /dev/null +++ b/docs/_posts/2024-04-15-pseudocode.md @@ -0,0 +1,71 @@ +--- +layout: post +title: a post with pseudo code +date: 2024-04-15 00:01:00 +description: this is what included pseudo code could look like +tags: formatting code +categories: sample-posts +pseudocode: true +--- + +This is an example post with some pseudo code rendered by [pseudocode](https://github.com/SaswatPadhi/pseudocode.js). The example presented here is the same as the one in the [pseudocode.js](https://saswat.padhi.me/pseudocode.js/) documentation, with only one simple but important change: everytime you would use `$`, you should use `$$` instead. Also, note that the `pseudocode` key in the front matter is set to `true` to enable the rendering of pseudo code. As an example, using this code: + +````markdown +```pseudocode +% This quicksort algorithm is extracted from Chapter 7, Introduction to Algorithms (3rd edition) +\begin{algorithm} +\caption{Quicksort} +\begin{algorithmic} +\PROCEDURE{Quicksort}{$$A, p, r$$} + \IF{$$p < r$$} + \STATE $$q = $$ \CALL{Partition}{$$A, p, r$$} + \STATE \CALL{Quicksort}{$$A, p, q - 1$$} + \STATE \CALL{Quicksort}{$$A, q + 1, r$$} + \ENDIF +\ENDPROCEDURE +\PROCEDURE{Partition}{$$A, p, r$$} + \STATE $$x = A[r]$$ + \STATE $$i = p - 1$$ + \FOR{$$j = p$$ \TO $$r - 1$$} + \IF{$$A[j] < x$$} + \STATE $$i = i + 1$$ + \STATE exchange + $$A[i]$$ with $$A[j]$$ + \ENDIF + \STATE exchange $$A[i]$$ with $$A[r]$$ + \ENDFOR +\ENDPROCEDURE +\end{algorithmic} +\end{algorithm} +``` +```` + +Generates: + +```pseudocode +% This quicksort algorithm is extracted from Chapter 7, Introduction to Algorithms (3rd edition) +\begin{algorithm} +\caption{Quicksort} +\begin{algorithmic} +\PROCEDURE{Quicksort}{$$A, p, r$$} + \IF{$$p < r$$} + \STATE $$q = $$ \CALL{Partition}{$$A, p, r$$} + \STATE \CALL{Quicksort}{$$A, p, q - 1$$} + \STATE \CALL{Quicksort}{$$A, q + 1, r$$} + \ENDIF +\ENDPROCEDURE +\PROCEDURE{Partition}{$$A, p, r$$} + \STATE $$x = A[r]$$ + \STATE $$i = p - 1$$ + \FOR{$$j = p$$ \TO $$r - 1$$} + \IF{$$A[j] < x$$} + \STATE $$i = i + 1$$ + \STATE exchange + $$A[i]$$ with $$A[j]$$ + \ENDIF + \STATE exchange $$A[i]$$ with $$A[r]$$ + \ENDFOR +\ENDPROCEDURE +\end{algorithmic} +\end{algorithm} +``` diff --git a/docs/_posts/2024-04-28-post-citation.md b/docs/_posts/2024-04-28-post-citation.md new file mode 100644 index 0000000..4b47a27 --- /dev/null +++ b/docs/_posts/2024-04-28-post-citation.md @@ -0,0 +1,11 @@ +--- +layout: post +title: a post that can be cited +date: 2024-04-28 15:06:00 +description: this is what a post that can be cited looks like +tags: formatting citation +categories: sample-posts +citation: true +--- + +This is an example post that can be cited. The content of the post ends here, while the citation information is automatically provided below. The only thing needed is for you to set the `citation` key in the front matter to `true`. diff --git a/docs/_posts/2024-04-29-typograms.md b/docs/_posts/2024-04-29-typograms.md new file mode 100644 index 0000000..6caff4e --- /dev/null +++ b/docs/_posts/2024-04-29-typograms.md @@ -0,0 +1,85 @@ +--- +layout: post +title: a post with typograms +date: 2024-04-29 23:36:10 +description: this is what included typograms code could look like +tags: formatting diagrams +categories: sample-posts +typograms: true +--- + +This is an example post with some [typograms](https://github.com/google/typograms/) code. + +````markdown +```typograms ++----+ +| |---> My first diagram! ++----+ +``` +```` + +Which generates: + +```typograms ++----+ +| |---> My first diagram! ++----+ +``` + +Another example: + +````markdown +```typograms +.------------------------. +|.----------------------.| +||"https://example.com" || +|'----------------------'| +| ______________________ | +|| || +|| Welcome! || +|| || +|| || +|| .----------------. || +|| | username | || +|| '----------------' || +|| .----------------. || +|| |"*******" | || +|| '----------------' || +|| || +|| .----------------. || +|| | "Sign-up" | || +|| '----------------' || +|| || +|+----------------------+| +.------------------------. +``` +```` + +which generates: + +```typograms +.------------------------. +|.----------------------.| +||"https://example.com" || +|'----------------------'| +| ______________________ | +|| || +|| Welcome! || +|| || +|| || +|| .----------------. || +|| | username | || +|| '----------------' || +|| .----------------. || +|| |"*******" | || +|| '----------------' || +|| || +|| .----------------. || +|| | "Sign-up" | || +|| '----------------' || +|| || +|+----------------------+| +.------------------------. +``` + +For more examples, check out the [typograms documentation](https://google.github.io/typograms/#examples). diff --git a/docs/_posts/2024-05-01-tabs.md b/docs/_posts/2024-05-01-tabs.md new file mode 100644 index 0000000..f3d6e2d --- /dev/null +++ b/docs/_posts/2024-05-01-tabs.md @@ -0,0 +1,122 @@ +--- +layout: post +title: a post with tabs +date: 2024-05-01 00:32:13 +description: this is what included tabs in a post could look like +tags: formatting code +categories: sample-posts +tabs: true +--- + +This is how a post with [tabs](https://github.com/Ovski4/jekyll-tabs) looks like. Note that the tabs could be used for different purposes, not only for code. + +## First tabs + +To add tabs, use the following syntax: + +{% raw %} + +```liquid +{% tabs group-name %} + +{% tab group-name tab-name-1 %} + +Content 1 + +{% endtab %} + +{% tab group-name tab-name-2 %} + +Content 2 + +{% endtab %} + +{% endtabs %} +``` + +{% endraw %} + +With this you can generate visualizations like: + +{% tabs log %} + +{% tab log php %} + +```php +var_dump('hello'); +``` + +{% endtab %} + +{% tab log js %} + +```javascript +console.log("hello"); +``` + +{% endtab %} + +{% tab log ruby %} + +```javascript +pputs 'hello' +``` + +{% endtab %} + +{% endtabs %} + +## Another example + +{% tabs data-struct %} + +{% tab data-struct yaml %} + +```yaml +hello: + - "whatsup" + - "hi" +``` + +{% endtab %} + +{% tab data-struct json %} + +```json +{ + "hello": ["whatsup", "hi"] +} +``` + +{% endtab %} + +{% endtabs %} + +## Tabs for something else + +{% tabs something-else %} + +{% tab something-else text %} + +Regular text + +{% endtab %} + +{% tab something-else quote %} + +> A quote + +{% endtab %} + +{% tab something-else list %} + +Hipster list + +- brunch +- fixie +- raybans +- messenger bag + +{% endtab %} + +{% endtabs %} diff --git a/docs/_posts/2024-05-22-community-bonding-week-1-and-2.md b/docs/_posts/2024-05-22-community-bonding-week-1-and-2.md deleted file mode 100644 index 412be2b..0000000 --- a/docs/_posts/2024-05-22-community-bonding-week-1-and-2.md +++ /dev/null @@ -1,22 +0,0 @@ ---- -layout: post -title: "Community Bonding: May 6 ~ May 19" -date: 2024-05-22 16:40:16 -description: Week 1 and 2 of the community bonding period -tags: -categories: ---- - - -I'm excited to be working with the JdeRobot community on the Robotics-Academy project. Google Summer of Code begins with a community bonding period, during which we familiarize ourselves with the community and explore the project to gain a better understanding. - -#### Objectives - -- [x] Set up blog website using Jekyll and Github Pages -- [x] Write a first blog for the community bonding period - -This week, we had our first official meeting where we introduced ourselves and the mentors reviewed the program's logistics. In addition to my project mentors, I also got to know the other contributors selected for GSoC 2024 JdeRobot, as well as other members of the organization. - -Before the official start of GSoC, I had already been using Robotics-Academy. I contributed by opening GitHub issues and submitting pull requests ([#2462](https://github.com/JdeRobot/RoboticsAcademy/pull/2462), [#2460](https://github.com/JdeRobot/RoboticsAcademy/pull/2460)). These contributions were for the RADI version 3.x.x, which is based on ROS Noetic. - -Also, the GSoC 2024 Contributor Summit was organized by the GSoC team. It included talks on AI and open source, security, OSS licensing, and diversity, equity, and inclusion (DEI), followed by Q&A sessions with the speakers. It was an informative and inspiring event for all the participants. \ No newline at end of file diff --git a/docs/_sass/_base.scss b/docs/_sass/_base.scss index c4b7f98..f6e3369 100644 --- a/docs/_sass/_base.scss +++ b/docs/_sass/_base.scss @@ -355,7 +355,8 @@ ul.task-list input[type="checkbox"] { } } -#light-toggle { +#light-toggle, +#search-toggle { padding: 0; border: 0; background-color: inherit; @@ -1109,3 +1110,16 @@ swiper-container { border-bottom: 2px solid var(--global-text-color); } } + +// Ninja Keys +// for more options, check https://github.com/ssleptsov/ninja-keys?tab=readme-ov-file#css-variables +ninja-keys { + --ninja-accent-color: var(--global-theme-color); + --ninja-icon-size: 0px; + --ninja-modal-background: var(--global-bg-color); + --ninja-z-index: 1031; +} + +ninja-keys::part(ninja-input-wrapper) { + background: var(--global-bg-color); +} diff --git a/docs/_sass/_themes.scss b/docs/_sass/_themes.scss index f65c5d1..e4d05d6 100644 --- a/docs/_sass/_themes.scss +++ b/docs/_sass/_themes.scss @@ -17,7 +17,7 @@ --global-divider-color: rgba(0, 0, 0, 0.1); --global-card-bg-color: #{$white-color}; --global-highlight-color: #{$red-color-dark}; - --global-back-to-top-bg-color: #{$black-color}; + --global-back-to-top-bg-color: rgba(#{red($black-color)}, #{green($black-color)}, #{blue($black-color)}, 0.4); --global-back-to-top-text-color: #{$white-color}; --global-tip-block: #42b983; @@ -79,7 +79,7 @@ html[data-theme="dark"] { --global-distill-app-color: #{$grey-color-light}; --global-divider-color: #424246; --global-card-bg-color: #{$grey-900}; - --global-back-to-top-bg-color: #{$white-color}; + --global-back-to-top-bg-color: rgba(#{red($white-color)}, #{green($white-color)}, #{blue($white-color)}, 0.5); --global-back-to-top-text-color: #{$black-color}; --global-tip-block: #42b983; diff --git a/docs/_sass/_variables.scss b/docs/_sass/_variables.scss index 9350923..85b6c72 100644 --- a/docs/_sass/_variables.scss +++ b/docs/_sass/_variables.scss @@ -43,8 +43,8 @@ $ti-font-path: "../fonts"; // Back To Top button config $back-to-top-z-index: 10; -$back-to-top-bottom: 50px; -$back-to-top-right: 50px; -$back-to-top-diameter: 56px; +$back-to-top-bottom: 30px; +$back-to-top-right: 30px; +$back-to-top-diameter: 40px; $back-to-top-height: $back-to-top-diameter; $back-to-top-width: $back-to-top-diameter; diff --git a/docs/_site/404.html b/docs/_site/404.html index 9050c5b..e1d2237 100644 --- a/docs/_site/404.html +++ b/docs/_site/404.html @@ -5,7 +5,7 @@ - + @@ -20,13 +20,15 @@ - Page not found | Prajyot Jadhav | JdeRobot x GSoC 2024 + Page not found | You R. Name - + + + @@ -37,18 +39,18 @@ - + - + - + @@ -60,13 +62,13 @@ - - + + - + - + @@ -92,8 +94,14 @@