https://github.com/jackaudio/jackaudio.github.com
jackaudio's Website and Wiki hosted at github
https://github.com/jackaudio/jackaudio.github.com
Last synced: about 1 year ago
JSON representation
jackaudio's Website and Wiki hosted at github
- Host: GitHub
- URL: https://github.com/jackaudio/jackaudio.github.com
- Owner: jackaudio
- Created: 2012-02-02T17:16:59.000Z (over 14 years ago)
- Default Branch: master
- Last Pushed: 2025-04-01T12:04:37.000Z (about 1 year ago)
- Last Synced: 2025-05-06T15:49:31.224Z (about 1 year ago)
- Language: HTML
- Homepage:
- Size: 3.44 MB
- Stars: 470
- Watchers: 48
- Forks: 77
- Open Issues: 39
-
Metadata Files:
- Readme: README.md
- Changelog: news/archive/index.md
Awesome Lists containing this project
README
# Source code for the [jackaudio.org] homepage
[![Travis build badge]](https://travis-ci.org/jackaudio/jackaudio.github.com)
## Contribute
To report bugs and issues with JACK, please use the corresponding
[JACK 1] and [JACK 2] bug trackers.
You can currently contribute to the homepage by checking the page for dead/wrong
links and formatting mistakes and file bugreports about them.
If you feel comfortable fixing issues yourself, please file a [pull request].
If you want to help out on the style part, you are more than welcome to clone the
repo and start hacking but please communicate about your vision,
so there won't be any drama.
If you have any ideas or suggestions, please feel free to contact the authors via
jack-devel mailinglist or on Github.
## Test with Jekyll locally
In order to test the website without having a webserver running and also see
the changes in real time use the `setup.sh` script to run [Jekyll] locally from
the repository directory.
It requires [ruby] to be installed, the rest will be installed locally in a
`.bundle` directory.
The current Gemfile configuration is set to use the same
Jekyll version as [GitHub pages].
The website will be available at .
If using another webserver you'll need to point it to the built `_site` directory.
## Adding FAQ pages
1. Create a new *.md file in the FAQ directory
2. Insert a [YAML front-matter] header as in the other files in the FAQ directory,
they are required for Jekyll to process the file
3. Add your content in markdown format
4. Link to your new FAQ page in the `/faq/index.md` page
## Creating posts
The easy way is by running the following command from the repository root:
```bash
$ ./new_post.sh "New post title" author_name
```
Otherwise manually by creating a new .md file in the [_posts] directory,
paying attention for a correct filename using a
`YYYY-MM-DD-lowercase-with-only-letters-numbers-and-hyphens-filename.md`
mask and [YAML front-matter] (see other post files as reference).
## Development notes
- All page links currently require the `.html` suffix in order to work with any
webserver, not to depend solely on Jekyll.
- Please use an [EditorConfig] compatible editor to avoid indentation,
whitespaces and missing lines at EOF issues.
- Desired line length maximum is 82 columns.
- See above to how to test page's changes with Jekyll.
- For further information please refer to the [Jekyll manual].
- Use external hosting links for the download section like [GitHub releases],
no download files in the repository for a better maintenance.
[jackaudio.org]: https://jackaudio.org
[JACK 1]: https://github.com/jackaudio/jack1/issues
[JACK 2]: https://github.com/jackaudio/jack2/issues
[pull request]: https://github.com/jackaudio/jackaudio.github.com/pulls
[Jekyll]: https://jekyllrb.com/
[ruby]: https://www.ruby-lang.org/en/
[GitHub pages]: https://pages.github.com/versions/
[YAML front-matter]: https://jekyllrb.com/docs/front-matter/
[_posts]: https://github.com/jackaudio/jackaudio.github.com/tree/master/_posts/
[EditorConfig]: https://editorconfig.org/
[Jekyll manual]: https://jekyllrb.com/docs/
[GitHub releases]: https://help.github.com/en/github/administering-a-repository/about-releases
[blog]: https://github.com/wxWidgets/website/tree/master/blog
[Travis build badge]:https://img.shields.io/travis/jackaudio/jackaudio.github.com.svg?label=Build&style=popout&logo=jekyll