Welcome to the ever-evolving, developer-led digital catalog of the Sound of our Cities project.

Introduction

One of the objectives of the project is technology transfer. AAU has made a template for showcasing the SooC sound works, and deployed the works online with a CC-License on GitHub: a web-based platform for version control using git. You can think Github also as a social media for developers: users can collaborate on or adopt open-source projects, fork code, share ideas and more. Here, you can maintain, extend, augment your project after the SooC lifetime. It is also easy and free to set-up a GitHub account and host your own portfolio using GitHub-pages.

Simple prerequisite for these are:

1. Have a GitHub account.

2. Have knowledge on how to use Git and GitHub.

3. Understand how GitHub-pages work: Free hosting as well though this is not mandatory.

4. Familiarize with (Github-flavored) markdown for editing your content. A comprensive guide is at https://github.github.com/gfm and a quick start at https://github.com/adam-p/markdown-here/wiki/Markdown-Cheatsheet

Contribute to the SooC Digital Catalog

• Login to your GitHub account or create one if you don't have any.

• Navigate to https://github.com/SooCities/SooCities.github.io. This Github repository is the back-end of our digital catalog https://SooCities.github.io/, and any changes you will make on the content will be published in a few minutes.

• If you are familiar with Github development, then follow the Developer Instructions at the SooC Wiki.

• If you are not familiar with editing, developing, and version-controlling at GitHub, then create an Issue: Press the Issues Tab next to "< > Code" on the above, and describe what you'd like to change and why. We will then

  • reply with suggestions how to implement your change

  • add you to the "Contributers" for future updates

  • walk through the Developer Instructions at the SooC Wiki for future contributions.

Embed Media

Check the media guide.

Make your own portfolio

• Follow the steps in https://docs.github.com/en/pages/quickstart

• Add content to your GitHub Pages site using Jekyll, as described in the GitHub Docs

You can also extend your portfolio with templates from, e.g., Start Bootstrap, Bootstrap Zero, Theme zy, Bootstrapmade, or any other place where you can download a quick portfolio template.

References

• Brian Mwevi, 2018: 8 steps to publishing your portfolio on GitHub | by Brian Mwevi | Tunapanda Institute | Medium