OpenHAB
/
openhab-docs
mirror of https://github.com/openhab/openhab-docs.git
1
0
Fork 0
Code Issues Projects Releases Wiki Activity

Fix and improve smaller typo and format fus 

Signed-off-by: Thomas Dietrich <Thomas.Dietrich@tu-ilmenau.de>
pull/154/head
Thomas Dietrich 2016-12-10 19:23:14 +01:00 committed by Kai Kreuzer
parent a357a6e724
commit 9aa9853e22
4 changed files with 44 additions and 41 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

12
appendix/contributing.md
View File

@ -7,9 +7,9 @@ title: Contributing to openHAB
# Contributing to openHAB
## Logging issues
## Reporting Issues
Use the table below to determine where your issue should be logged:
Use the table below to determine where your issue or idea for improvement should be reported:
Issue | Where to report
------|----------------
@ -27,20 +27,20 @@ We want to keep the openHAB community awesome, growing and collaborative. We
need your help to keep it that way. To help with this we've come up with some
general guidelines for the community as a whole:
* Be nice: Be courteous, respectful and polite to fellow community members: no
* **Be nice:** Be courteous, respectful and polite to fellow community members: no
regional, racial, gender, or other abuse will be tolerated. We like nice people
way better than mean ones!
* Encourage diversity and participation: Make everyone in our community
* **Encourage diversity and participation:** Make everyone in our community
feel welcome, regardless of their background and the extent of their
contributions, and do everything possible to encourage participation in
our community.
* Keep it legal: Basically, don't get us in trouble. Share only content that
* **Keep it legal:** Basically, don't get us in trouble. Share only content that
you own, do not share private or sensitive information, and don't break the
law.
* Stay on topic: Make sure that you are posting to the correct channel
* **Stay on topic:** Make sure that you are posting to the correct channel
and avoid off-topic discussions. Remember when you update an issue or
respond to an email you are potentially sending to a large number of
people. Please consider this before you update. Also remember that

31
developers/prerequisites/equinox.md
View File

@ -41,8 +41,7 @@ Then follow these steps:
6. Click on "Validate Bundles" and make sure that "No problems were detected" is displayed.
7. You can start Equinox with the "Run" button.
<img src="images/runconfiguration.png" width="600"/>
Picture 1. Run Configurations dialog window
![Run Configurations dialog window](images/runconfiguration.png)
If you use Eclipse for an IDE, this will be the easiest way to run your bundles in an Equinox runtime. If you do not have experience with writing OSGi bundles, go to our [coding tasks page](osgitasks.html).
@ -50,13 +49,15 @@ If you use Eclipse for an IDE, this will be the easiest way to run your bundles
The **org.eclipse.osgi** bundle is the framework implementation of the Core Framework R4 specification in a standalone package.
You can get it from your [Eclipse IDE installation for openHAB](../development/ide.html) (if you're using Windows, it should be located at *C: / Users / your.name / .p2 / pool / plugins / org.eclipse.osgi_3.x.x_xxxx.jar*).
You can get it from your [Eclipse IDE installation for openHAB](../development/ide.html) (If you're using Windows, it should be located at `C:\Users\your.name\.p2\pool\plugins\org.eclipse.osgi_3.x.x_xxxx.jar`).
1. Equinox versions before 3.8.0.M4.
In some older version of Equinox, using the following command line:
``` java -jar org.eclipse.osgi_3.x.x_xxxx.jar -console ```
```shell
java -jar org.eclipse.osgi_3.x.x_xxxx.jar -console
```
was enough to run it standalone.
@ -64,17 +65,17 @@ was enough to run it standalone.
Starting from Equinox 3.8.0.M4, it has a new console. So the command line above will probably not work. You need some additional bundles in order to run Equinox properly. There are different ways to add those bundles and one of them is given below:
1. After you have downloaded and installed Eclipse IDE for openHAB, find your .p2 repository and go to the *plugins* folder. (if you're using Windows, it should be located at *C: / Users / your.name / .p2 / pool / plugins*).
1. After you have downloaded and installed Eclipse IDE for openHAB, find your .p2 repository and go to the `plugins` folder. (if you're using Windows, it should be located at `C:\Users\your.name\.p2\pool\plugins`).
2. Make sure that there is a *org.eclipse.osgi_3.x.x_xxxx.jar* in that folder.
2. Make sure that there is a `org.eclipse.osgi_3.x.x_xxxx.jar` in that folder.
3. Create *configuration* folder in the *plugins* folder.
3. Create `configuration` folder in the `plugins` folder.
4. Inside the *configuration* folder create a file *config.ini*.
4. Inside the `configuration` folder create a file `config.ini`.
5. Save the following content in the *config.ini* file:
5. Save the following content in the `config.ini` file:
```
```ini
osgi.bundles=\
org.eclipse.core.runtime,\
org.eclipse.equinox.common,\
@ -82,7 +83,7 @@ Starting from Equinox 3.8.0.M4, it has a new console. So the command line above
org.eclipse.equinox.registry,\
org.eclipse.equinox.preferences,\
org.eclipse.core.contenttype,\
org.eclipse.equinox.app,\
org.eclipse.equinox.app,\
org.eclipse.equinox.console,\
org.apache.felix.gogo.runtime,\
org.apache.felix.gogo.shell,\
@ -94,7 +95,9 @@ Starting from Equinox 3.8.0.M4, it has a new console. So the command line above
6. Use the following command line to run Equinox:
```java -jar org.eclipse.osgi_3.x.x_xxxx.jar -console -configuration configuration```
```shell
java -jar org.eclipse.osgi_3.x.x_xxxx.jar -console -configuration configuration
```
## IV. Commands
@ -102,7 +105,7 @@ Once you have Equinox running, you will see a prompt. Some of the basic
osgi commands are:
Command | Description
-------|-------
--------|-------
*help* | Basic command that will list all available commands
*install* [bundle URL] | Installs the bundle from the given URL
*start* [bundle # or bundle name] | Starts the bundle with the given numeric or symbolic id
@ -176,7 +179,7 @@ artifacts.jar
content.jar
site.xml
```
Some of the most popular p2 repositories are [orbit p2 Repo](http://download.eclipse.org/tools/orbit/downloads/drops/R20160221192158/) and [Eclipse p2 Repo](http://download.eclipse.org/eclipse/updates/4.5).
Some of the most popular p2 repositories are [orbit p2 Repo](http://download.eclipse.org/tools/orbit/downloads/drops/R20160221192158/) and [Eclipse p2 Repo](http://download.eclipse.org/eclipse/updates).
You can find information about the Eclipse SmartHome**<sup>TM</sup>** update sites at [this link](http://www.eclipse.org/smarthome/documentation/community/downloads.html).

4
installation/linux.md
View File

@ -123,7 +123,7 @@ If everything went well, start openHAB and register it to be automatically execu
The first start may take **up to 15 minutes**, this is a good time to reward yourself with hot coffee or a freshly brewed tea!
You should be able to reach the openHAB 2 portal at [http://openhab-device:8080](http://192.168.0.3:8080) at this point.
You should be able to reach the openHAB 2 portal at [http://openhab-device:8080]() at this point.
![The openHAB 2 portal page](images/Accueil_Openhab_2.png)
@ -233,7 +233,7 @@ sudo chown -hR openhab:openhab /opt/openhab2
```
Everything is ready for a first test run.
**Execute** openHAB and you should be able to reach the openHAB 2 Portal at [http://openhab-device:8080](http://192.168.0.3:8080) after a few minutes:
**Execute** openHAB and you should be able to reach the openHAB 2 Portal at [http://openhab-device:8080]() after a few minutes:
```shell
# execute as restricted user openhab:

4
tutorials/beginner/index.md
View File

@ -6,8 +6,8 @@ layout: tutorial-beginner
# Overview
This part covers all the basic use of openHAB: how to install a binding, how to configure them, the inbox....
This part covers all the basic use of openHAB 2.0: how to install a binding, how to configure them, the inbox....
The goal is to cover a first level of usage with the example of a simple binding: the _System info_ binding. This binding System provides operating system and hardware information.
{% include contribution-wanted.html %}