major: flatten the project
This commit is contained in:
68
README.md
68
README.md
@ -1,6 +1,13 @@
|
||||
# Hubl
|
||||
|
||||
Hubl is the magic tool that allows the Freelance Network to thrive in a decentralized way.
|
||||
<h1 align="center">
|
||||
<br>
|
||||
<a href="http://hubl.world"><img src="https://cdn.startinblox.com/logos/hubl-logo.png" alt="Hubl" width="200"></a>
|
||||
<br>
|
||||
</h1>
|
||||
|
||||
<h4 align="center">A magic tool that allows the Freelance Network to thrive in a decentralized way, built on top of <a href="https://startinblox.com/" target="_blank">Startin'blox</a>.</h4>
|
||||
|
||||
<hr>
|
||||
|
||||
## Getting Started
|
||||
|
||||
@ -43,13 +50,6 @@ npm install
|
||||
|
||||
Then create a `config.json` based on your needs, see Mandatory and Optional Modules on this page. For convienence a `config.sample.json` exists in the source.
|
||||
|
||||
Federated Hubl needs to use `config.sample.federated.json` example.
|
||||
|
||||
You can quickly update your API URI from the samples:
|
||||
```
|
||||
$ sed 's/http:\/\/localhost:8000/https:\/\/api.your-server.startinblox.com/' config.sample.json > config.json
|
||||
```
|
||||
|
||||
Then build your new Hubl:
|
||||
|
||||
```bash
|
||||
@ -76,7 +76,7 @@ On `config.json`:
|
||||
|
||||
```json
|
||||
{
|
||||
"xmpp": "https://jabber.happy-dev.fr/http-bind/",
|
||||
"xmppWebsocket": "wss://jabber.happy-dev.fr/xmpp-websocket",
|
||||
"clientName": "My local Hubl",
|
||||
"clientLogo": "/images/logo.webp",
|
||||
"authority": "http://localhost:8000/",
|
||||
@ -92,7 +92,7 @@ Where:
|
||||
|
||||
* `clientName` is the name of your Hubl
|
||||
* `clientLogo` is an URL to an image file
|
||||
* `xmpp` is your [Prosody](https://prosody.im/) with [appropriate modules](https://git.startinblox.com/infra/prosody-modules/) configured on.
|
||||
* `xmppWebsocket` is your [Prosody](https://prosody.im/) with [appropriate modules](https://git.startinblox.com/infra/prosody-modules/) configured on.
|
||||
* `authority` is the OpenID Provider. Usually, if you use `djangoldp-account` it's the same as your djangoldp server.
|
||||
* `endpoints.users` is the API endpoints for Users on your djangoldp server. (djangoldp-account)
|
||||
* `endpoints.skills` is the API endpoints for Skills on your djangoldp server. (djangoldp-skill)
|
||||
@ -113,9 +113,7 @@ Don't forget to set some users as admin from the Django Admin if you want to all
|
||||
On `config.json`:
|
||||
|
||||
```json
|
||||
"clientName": "Hubl",
|
||||
"clientFavicon": "/images/favicon.webp",
|
||||
"clientLogo": "/images/logo.webp",
|
||||
"clientLogoHeight": "32px",
|
||||
"clientCSS": "/path/to/custom.css",
|
||||
"authorityName": "djangoldp-server-name"
|
||||
@ -123,9 +121,7 @@ On `config.json`:
|
||||
|
||||
Where:
|
||||
|
||||
* `clientName` is the name of your Hubl.
|
||||
* `clientFavicon` is an URL to a distant favicon
|
||||
* `clientLogo` is an URL to a distant logo for your client
|
||||
* `clientLogoHeight` allow a quick fix to manage different height logos
|
||||
* `clientCSS` is an URL to a distant CSS that'll be the last one loaded by the Hubl
|
||||
* `authorityName` is a visual name of your OpenID Provider
|
||||
@ -174,7 +170,23 @@ On `config.json`:
|
||||
}
|
||||
```
|
||||
|
||||
A [sample fixture](https://git.startinblox.com/djangoldp-packages/djangoldp-dashboard/blob/master/djangoldp_dashboard/fixtures/sample.json) can be loaded with `./manage.py loaddata path/to/djangoldp_dashboard/fixtures/sample.json`.
|
||||
A [sample fixture](https://git.startinblox.com/djangoldp-packages/djangoldp-dashboard/blob/master/djangoldp_dashboard/fixtures/sample.json) can be loaded with `./manage.py loaddata sample`.
|
||||
|
||||
### Job Offers
|
||||
|
||||
Job Offers includes a job board with conversation. To activate them, you need:
|
||||
|
||||
On Server: `djangoldp_joboffer`, `djangoldp_skill`, `djangoldp_upload`, `djangoldp_conversation` packages
|
||||
|
||||
On `config.json`:
|
||||
|
||||
```json
|
||||
"endpoints": {
|
||||
"joboffers": "http://server.url/job-offers/",
|
||||
"skills": "http://server.url/skills/",
|
||||
"uploads": "http://server.url/upload/"
|
||||
}
|
||||
```
|
||||
|
||||
### Project
|
||||
|
||||
@ -210,21 +222,7 @@ On `config.json`:
|
||||
}
|
||||
```
|
||||
|
||||
### Job Offers
|
||||
|
||||
Job Offers includes a job board with conversation. To activate them, you need:
|
||||
|
||||
On Server: `djangoldp_joboffer`, `djangoldp_skill`, `djangoldp_upload`, `djangoldp_conversation` packages
|
||||
|
||||
On `config.json`:
|
||||
|
||||
```json
|
||||
"endpoints": {
|
||||
"joboffers": "http://server.url/job-offers/",
|
||||
"skills": "http://server.url/skills/",
|
||||
"uploads": "http://server.url/upload/"
|
||||
}
|
||||
```
|
||||
## Optional community modules
|
||||
|
||||
### Events
|
||||
|
||||
@ -305,6 +303,12 @@ docker push registry.startinblox.com/applications/hubl/server:0.1
|
||||
|
||||
Note: within a Kubernetes pod all services are bound to `localhost`.
|
||||
|
||||
## Troubleshooting
|
||||
|
||||
### Circles or Projects are missing the @user list
|
||||
|
||||
Did you properly created subscriptions on your DjangoLDP's server? You can quickly create them with `./manage.py create_subscriptions`
|
||||
|
||||
## Built With
|
||||
|
||||
* [Sib-Core](https://git.startinblox.com/framework/sib-core/) - An awesome new framework!
|
||||
* [Sib-Core](https://git.startinblox.com/framework/sib-core/) - A SOLID-Complient framework
|
||||
|
Reference in New Issue
Block a user