Repository maintains the SRA Blog. It is accessible here: https://blog.sravjti.in/
- Uses Jekyll to generate the static webpage.
- Uses the theme
bitbrain/jekyll-dash - Output from Jekyll is pushed to
gh-pagesbranch using github actions. Github Pages is configured to usegh-pagesbranch. - It uses Github Actions to publish the generated jekyll blog to
gh-pages, normal github pages jekyll build pipeline can't be used to generate tags, so we manually build using github actions and push togh-pagesbranch. - It uses the following github action
helaili/jekyll-action@2.0.4
- Fork this repo.
- All assets like images or videos or gif should go into
/assets/posts/, create a new subfolder for the specific post, let's say the blog title ishow to use github pages, then create a folder like/assets/posts/how-to-use-github-pages. - The content should be written in markdown, the file should go into
_postsfolder. - File should be named as follows,
<year>-<month>-<date>-article-name.md. - Let's say today's date is 13th June 2021, then the filename is expected to be
2021-06-13-hoe-to-use-github-pages.md - Each markdown file must begin with the following predicate
--- layout: post title: <name of the article> tags: <specific tag with which you want to classify the article, can be something like OpenCV, embedded-system, it shouldn't have spaces> description: <put a short description of the topic here> --- -- [Author's name](Link-to-their-github-account)
- Add your content below, it's good idea to begin with a heading with single
#, and go on. For using images follow the following path convention/assets/posts/<name-of-the-post-folder>/<filename>, for example something like this can be done to insert a image - For reference go through this markdown file: https://raw.githubusercontent.com/SRA-VJTI/blog/master/_posts/2020-09-14-using-jekyll-with-github-pages-1.md
- Verify that the changes are correct by running it on your local machine, you need bundle and jekyll installed, instructions are here
# cd into the repository gem install jekyll bundler bundle exec jekyll serve # Visit here http://localhost:4000 to see your changes
- Commit the changes and file a Pull Request. Please use a proper title, and a short description of the blog post.
MIT License
Copyright (c) 2021 Society of Robotics and Automation
Permission is hereby granted, free of charge, to any person obtaining a copy
of this software and associated documentation files (the "Software"), to deal
in the Software without restriction, including without limitation the rights
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
copies of the Software, and to permit persons to whom the Software is
furnished to do so, subject to the following conditions:
The above copyright notice and this permission notice shall be included in all
copies or substantial portions of the Software.
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
SOFTWARE.