How to add a Project ?

Instructions - Create the repository using existing template

1. First create a repository on cepdnaclk GitHub organization using one of the following template. (Click on the relevant link)

2. Select the Owner as “cepdnaclk”

3. Name your repository, according to the below naming convention.

eYY-CATEGORY-TITLE

  • YY: 2 digit batch number
  • CATEGORY: One of the following supported category tags
  • TITLE: A suitable name for your project (You can use both capital and simple letters, words can be seprated using ‘-‘)


Ex: For E15 Final Year project: e15-4yp-Project-Name
CATEGORY assigned as follows,
CATEGORY Project / Course
4yp Undergraduate Research Project
3yp Cyber-Physical Systems Project
6sp Sixth Semester Project
co225 Software Construction Projects
co227 Software Systems Projects
co328 Software Engineering Project
co226 Database Projects
co326 Computer Systems Engineering Projects
co502 Advanced Computer Architecture
co543 Image Processing
co542 Neural Networks
co544 Machine Learning

4. Add a proper description about your project in between 100-150 words.

5. Select the visibility as Public.

6. Click on the Create repository from template button.

instructions for step 2 to 6

7. Go to settings and scroll to the GitHub pages section.

8. Select branch as Main and Folder as /docs and save.

instructions for step 7 to 8

9. Now you can goto the repository and edit your GitHub page by editing the /docs/README.md. (The webpage shown in https://cepdnaclk.github.io/{your-repository-name} will be automatically generated. [Example])
Note: if you are using a ‘Minimal’ template, you need to design this project page by your own, by editing /docs/index.html

10. You can share your project’s source code / implementations into this repository, by uploading them into the root folder of the repository.

11. These projects will be automatically added into https://projects.ce.pdn.ac.lk, with given title and description. If you like to show more details about your project on this site, you can fill the JSON file, /docs/data/index.json (Note: Different templates may have different sets of parameters, as requested by the course coordinators)


{
    "title": "This is the title of the project",
    "team": [
    {
        "name": "Team Member Name 1",
        "email": "email@eng.pdn.ac.lk",
        "eNumber": "E/yy/xxx"
    },
    {
        "name": "Team Member Name 2",
        "email": "email@eng.pdn.ac.lk",
        "eNumber": "E/yy/xxx"
    },
    {
        "name": "Team Member Name 3",
        "email": "email@eng.pdn.ac.lk",
        "eNumber": "E/yy/xxx"
    }
    ],
    "supervisors": [
    {
        "name": "Dr. Supervisor 1",
        "email": "email@eng.pdn.ac.lk"
    },
    {
        "name": "Supervisor 2",
        "email": "email@eng.pdn.ac.lk"
    }
    ],
    "tags": ["Web", "Embedded Systems"]
}
            
NOTES:
  1. Once you filled this index.json file, please make sure the syntax is correct. (You can use this tool to identify syntax errors)
  2. Please include the "correct" email address of your supervisors. (You can find them from https://people.ce.pdn.ac.lk/)
  3. If your followed all the given instructions correctly, your repository will be automatically added to the department's project web site (Update daily)
  4. A HTML template integrated with the given GitHub repository templates, based on github.com/cepdnaclk/eYY-project-theme. If you like to remove this default theme and make your own web page, you can remove the file, docs/_config.yml and create the site using HTML.

Instructions - Fork your existing repository into cepdnaclk