freifunk/projects

Name: projects

Owner: Freifunk

Description: A website that showcases interesting projects, using Angular JS.

Forked from: coala/projects

Created: 2017-11-21 08:53:16.0

Updated: 2018-03-23 17:22:21.0

Pushed: 2018-03-23 17:22:20.0

Homepage: https://projects.coala.io/

Size: 609

Language: JavaScript

GitHub Committers

User	Most Recent Commit	# Commits

Other Committers

User	Email	Most Recent Commit	# Commits

README

Projects

A website that showcases projects! If you want to use it and it's not exactly fitting your purpose, please do make upstream changes. We expect this project to be of use to others and we're happy to make it more generic so it's easier to adapt to other organizations. This was built by coala community, to view live projects visit projects.coala.io

(It'd be nice to have an organization YML or so e.g.)

Purpose

This is designed for GSoC but can be used for other initiatives at the same time. We use it for research theses, GSoC, GCI and maybe others in the future.

Why?

• It's way more appealing to students.
• You can search and filter projects.
• Project ideas as structured data are more concise and you're sure to have all points covered - at the same time we can show students an overview and showing the full information only when needed.
• A proper review process can be used for triaging and iterating on project ideas.
• Stop wasting time maintaining a mentors list. This can be generated from the projects.

Usage

To clone the repository and run this website on your local machine, install Jekyll for your OS and type the following commands:

$ sudo gem install jekyll bundler
$ git clone https://github.com/coala/projects.git
$ cd projects
$ bundle install
$ bundle exec jekyll serve

Then you can simply go to either of the following addresses in your browser to access the site:

127.0.0.1:4000
localhost:4000

If you face problems while installing Jekyll or using its gem bundler you may go through its troubleshooting docs

Defining Projects

Mentors and admins can define projects in markdown using the following structure and save it in the _projects folder with a relevant filename:

: "Write Project Name Here"
: "Write a one line Description of Project here."
irements:
The applicant has to fulfill this to get started."
iculty: "low|medium|high"
es:
https://github.com/coala/coala/issues/####"
ors:
ils
ims1253
iatives:
SoC
:
lugins
I
aborating_projects:
Add umbrella and sub-orgs here"


 space is for the main description. Use it wisely. 

 Milestones

# GSOC 2017 COMMUNITY BONDING

nceptual work should be finished.
e student have a repository, know how to work with the community.
e applicant should know the community.

# GSOC 2017 MIDTERM

erything listed here has to be reviewed and merged by midterm.
 exceptions to that. Changing the goals is possible together with mentors.
s, that includes tests and documentation.

# GSOC 2017 FINAL

erything has to be reviewed and merged.
cluding tests and docs, again.

Defining FAQs

Users can also add FAQs by simply creating a markdown file in _faq folder.

Format for faq markdown file is as follows:

tion: <Write the question here>


er

Multi Language Support

coala Projects supports multiple 'human languages'. To add a translation of a project in a language, the following steps can be followed:

• Create a folder with language code in `data/locale` folder.
• Create `faq.json, ``projects.json`,faq`` and `projects` folder if they do not exist already.
• Add translated content of a project inside `projects` folder. The names of the file should be same.
• Similiarly translated content of a faq goes inside `data/locale/ < language-id > /faq` folder.
• For the faq.json and projects.json metadata, refer to Bahasa and Hindi Translations available in `data/locale` directory.
• Lastly, in `resources/js/app.js` file, Add the new language json in Language service.