Welcome to the DSAI-NLP GitHub repository! This guide will walk you through the steps to contribute to our GitHub Page. Whether you're fixing a bug, adding content, or updating existing information, your contributions are invaluable to the success of our project.
When creating pull requests, please ensure you are submitting them to the correct base repository, which is dsai-nlp/dsai-nlp.github.io
, not the original alshedivat/al-folio
repo from which this project was forked. You can select the base repository when you open a pull request on GitHub. For more details, please refer to our contribution guidelines.
For ease of setup and to avoid compatibility issues with Ruby and Jekyll versions, we recommend using Docker for local development. This method isolates the environment and works consistently across different operating systems.
Before you begin, ensure you have Docker installed on your system. If you haven't already, you can download and install Docker from the following links:
After installing Docker and Docker Compose, follow these steps to run the website on your local machine:
Open a terminal and navigate to the root directory of your forked version of the dsai-nlp/dsai-nlp.github.io
repository.
Run the following command to pull the latest pre-built Jekyll image from DockerHub:
docker compose pull
Once the image is pulled, start the Docker container with:
docker compose up
This command will start a local web server running the website.
http://localhost:8080
. You should see the local version of the website running.Now that you have the site running locally, you can begin customizing the theme to suit your needs.
To start contributing, please follow these steps:
Before making any changes, you'll need your own copy of the repository. Fork the repo by clicking on the 'Fork' button at the top right corner of this page. This will create a copy of the repository in your own GitHub account.
Once you have your forked copy, create a new branch on your repository. This branch should be named appropriately based on the edits you intend to make. For example, if you're adding a new event, you might name your branch add-new-event
.
git checkout -b your-branch-name
With your new branch checked out, you're ready to make the changes or additions you have in mind. Feel free to update existing content, add new files, or make any other necessary modifications.
After you've made your changes, commit them with a clear and concise commit message. Then, push your changes to your forked repository.
git add .
git commit -m "A brief description of your changes"
git push origin your-branch-name
Navigate to your forked repository on GitHub, switch to your branch, and click on the 'Pull Request' button. Ensure that the base repository is set to dsai-nlp/dsai-nlp.github.io
and the base branch is master
. Fill in some details about your changes in the pull request message and submit it.
Once your pull request is submitted, it will be reviewed by the maintainers of the original repository. If everything looks good, your changes will be merged into the master branch. If there are any additional changes needed, maintainers will provide feedback on your pull request.
Thank you for your contributions to the DSAI-NLP GitHub Page. Together, we're building a comprehensive and valuable resource for the NLP community!
Replace the placeholders such as your-branch-name
and the commit message with the relevant information for your specific changes.
To add your profile to the NLP@DSAI team page:
_members
directory..md
) with a suitable name, e.g., john_doe.md
.---
name: Your Name
image: path_to_your_image
position: Your Position
state: current # Options: current, master, alumni
start-date: YYYY-MM-DD
end-date: YYYY-MM-DD # If applicable
pronouns: your pronouns
email: your_email@domain.com
# Add any of the following that apply to you:
scholar_userid:
publons_id:
research_gate_profile:
github_username:
linkedin_username:
twitter_username:
medium_username:
quora_username:
blogger_url:
work_url:
wikidata_id:
strava_userid:
keybase_username:
gitlab_username:
dblp_url:
description: "A short personal bio or description."
---
To add an event:
_events
directory..yaml
) with a suitable name, e.g., nlp_fika_event.yaml
.---
layout: event_layout_type # Options: reading-group, fika, seminar, talk
speaker: Speaker's Name
title: "Event Title"
bio: "Speaker's bio."
abstract: "Short description of the event."
image: assets/events/event_image.png
start: YYYY-MM-DDTHH:MM:SS+HH:MM # Start time and timezone offset
end: YYYY-MM-DDTHH:MM:SS+HH:MM # End time and timezone offset
# Add any of the following that apply to your event:
youtube:
slides:
zoomroom:
zoompassword:
---
To add an announcement:
_news
directory..md
) with a suitable name, e.g., conference_announcement.md
._news
folder for the announcement, filling in the relevant details.To add or update information about a course:
_pages
directory.courses.md
file.To add or update publications:
_bibliography
directory.papers.bib
file.After making any of the above changes, follow the standard contribution workflow:
dsai-nlp/dsai-nlp.github.io
.The repository maintainers will review your pull request and merge it upon approval. Make sure to provide detailed information in your pull request to expedite the review process.