bndtools / bndtools.github.io

Bndtools.org Main Site

Bndtools.org Main Website

=====================

This repository holds the bndtools.org website hosted at https://bndtools.org. This web site is maintained as markdown and turned into HTML by Jekyll using GitHub Pages.

Local development

• install ruby 2.7
• call ./run.sh on the commandline

This should install jekyll and start a local webserver at:

• http://127.0.0.1:4000/

Start editing markdown .md files. Jekyll will auto-detect changes and reload the website. Some changes require a restart (e.g. changes to _config.yml)

CSS Styling for Code Highlighter

• jekyll uses rouge code highlighter
• see _config.yml and section syntax_highlighter_opts
• also see this website https://jekyll-themes.com/brazacz/rouge-themes for examples
• rouge is compatible with and can use 'pygments' styles (see https://pygments.org/styles/)
• these styles can be generated with the command

The following commands locally will help to generate the .css files for the pygment styles:

gem install rouge

# show a list of supported styles
rougify help style

# go to the css folder
cd css

# generate the css
rougify style monokai > monokai.css

Then reference the .css file in _includes/head.html

Feedback

Feedback is always welcome. For general discussions use the [email protected] list. We also have the [email protected] list for discussions on the development of bndtools.

Bugs and issues for the https://bndtools.org website should go to https://github.com/bndtools/bndtools.github.io/issues

Contributing

Want to hack on the bndtools.org website? See CONTRIBUTING.md for information on building, testing and contributing changes.

They are probably not perfect, please let us know if anything feels wrong or incomplete.

License

The contents of this repository are made available to the public under the terms of the Eclipse Public License v1.0.

bndtools.github.io's Issues

Document Time Unit of max.stale property

Please document how the max.stale Property of OSGi Repositories should be configured.
What ist the meaning of the integer to specify, e.g. the time unit ?

https://bnd.bndtools.org/plugins/osgirepo.html

@IMAGES Pasted Images for the website [do not delete]

Update acknowledge page

https://bndtools.org/acknowledge.html

Contains old info

Support compositeContent/Artifacts on bndtools.github.com for easier install

By placing a compositeContent.xml and compositeArtifacts.xml which links to the Amazon S3 update site at the root of the website would allow users to put http://bndtools.org as an update site but still download content from the Amazon site instead.

Replace cloudbees references

Cloudbees build is now being shutdown. This site needs to be updated to point to a new location for dev builds of Bndtools.

BndTools "What's New" welcome screen points to 2.0 documentation

The welcome feature item has a "What's New" that points to the 2.0 documentation, even though the feature installed is 2.1.

Invalid information in tutorial

The tutorial points the user to "Declarative Services" in "Contents" tab which seems to not exist anymore. Maybe this is the reason why g! greet World throws gogo: CommandNotFoundException: Command not found: greet.

Additionally it states The command component is not part of the provider bundle, because it lives in a package that was not included. I already figured it out that org.example.impls must be added to Private Packages of the provider descriptor, but it was not mentioned anywhere before.

Moreover aQute.bnd.annotation seems to not exist anymore as well, therefore @Component no longer contains provide = Object.class setting.

Several screenshots are outdated as well.

Missing eclipse update site for bndtools 3.4.2.REL

Unfortunately I don't see any eclipse updated site for bndtools plugin for eclipse. Unfortunale we are still sing legacy osgi project with eclipse bndtool 3.4.2.REL. Somehow this link was working https://dl.bintray.com/bndtools/bndtools/3.4.0/ but this one alo not available.

Remove fonts fetched via fonts.googleapis.com

Currently the css files import fonts from a google server via //fonts.googleapis.com
From a privacy perspective it would be better to serve those fonts statically ourselves, so that the site loads without HTTP calls to 3rd parties.

I will try to create a PR for this.