Skip to content

Commit 8685368

Browse files
committed
Update docs
1 parent faae854 commit 8685368

3 files changed

Lines changed: 75 additions & 34 deletions

File tree

DEVELOP.md

Lines changed: 17 additions & 14 deletions
Original file line numberDiff line numberDiff line change
@@ -6,19 +6,12 @@ Before starting make sure your development environment is properly set. See [Vol
66

77
1. Make sure you have installed `yo`, `@plone/generator-volto` and `mrs-developer`
88

9-
$ npm install -g yo
10-
$ npm install -g @plone/generator-volto
11-
$ npm install -g mrs-developer
9+
npm install -g yo @plone/generator-volto mrs-developer
1210

1311
1. Create new volto app
1412

15-
$ yo @plone/volto \
16-
my-dev-project \
17-
--addon @eeacms/volto-columns-block \
18-
--workspace src/addons/volto-columns-block \
19-
--no-interactive \
20-
--skip-install
21-
$ cd my-dev-project
13+
yo @plone/volto my-volto-project --addon @eeacms/volto-columns-block --workspace src/addons/volto-columns-block --skip-install
14+
cd my-volto-project
2215

2316
1. Add the following to `mrs.developer.json`:
2417

@@ -33,21 +26,31 @@ Before starting make sure your development environment is properly set. See [Vol
3326

3427
1. Install
3528

36-
$ yarn develop
37-
$ yarn
29+
yarn develop
30+
yarn
3831

3932
1. Start backend
4033

41-
$ docker run -d --name plone -p 8080:8080 -e SITE=Plone plone
34+
docker pull plone
35+
docker run -d --name plone -p 8080:8080 -e SITE=Plone -e PROFILES="profile-plone.restapi:blocks" plone
4236

4337
...wait for backend to setup and start - `Ready to handle requests`:
4438

45-
$ docker logs -f plone
39+
docker logs -f plone
4640

4741
...you can also check http://localhost:8080/Plone
4842

4943
1. Start frontend
5044

45+
yarn start
46+
47+
1. Go to http://localhost:3000
48+
49+
1. Happy hacking!
50+
51+
cd src/addons/volto-columns-block/
52+
frontend
53+
5154
$ yarn start
5255

5356
1. Go to http://localhost:3000

README.md

Lines changed: 44 additions & 17 deletions
Original file line numberDiff line numberDiff line change
@@ -10,8 +10,6 @@
1010
This package gives you a block with columns. Each column is its own separate
1111
blocks container.
1212

13-
###
14-
1513
![Initializing Columns Layout](https://raw.githubusercontent.com/eea/volto-columns-block/docs/docs/initialize.png)
1614
![Columns Edit Example](https://raw.githubusercontent.com/eea/volto-columns-block/docs/docs/edit.png)
1715
![Columns Sidebar](https://raw.githubusercontent.com/eea/volto-columns-block/docs/docs/columns-sidebar.png)
@@ -20,37 +18,59 @@ blocks container.
2018

2119
## Getting started
2220

23-
1. Create new volto project if you don't already have one:
21+
### Try volto-columns-block with Docker
22+
23+
1. Get the latest Docker images
24+
25+
```
26+
docker pull plone
27+
docker pull plone/volto
28+
```
29+
30+
1. Start Plone backend
31+
```
32+
docker run -d --name plone -p 8080:8080 -e SITE=Plone -e PROFILES="profile-plone.restapi:blocks" plone
33+
```
34+
35+
1. Start Volto frontend
2436

2537
```
26-
$ npm install -g yo @plone/generator-volto
27-
$ yo @plone/volto \
28-
my-volto-project \
29-
--addon @eeacms/volto-columns-block \
30-
--no-interactive \
31-
--skip-install
32-
33-
$ cd my-volto-project
34-
$ yarn add -W @eeacms/volto-columns-block
38+
docker run -it --rm -p 3000:3000 --link plone -e ADDONS="@eeacms/volto-columns-block" plone/volto
3539
```
3640

37-
1. If you already have a volto project, just update `package.json`:
41+
1. Go to http://localhost:3000
42+
43+
### Add volto-columns-block to your Volto project
44+
45+
1. Make sure you have a [Plone backend](https://plone.org/download) up-and-running at http://localhost:8080/Plone
46+
47+
1. Start Volto frontend
48+
49+
* If you already have a volto project, just update `package.json`:
3850

3951
```JSON
4052
"addons": [
41-
"@eeacms/volto-columns-block"
53+
"@eeacms/volto-columns-block"
4254
],
4355

4456
"dependencies": {
45-
"@eeacms/volto-columns-block": "^2.0.0"
57+
"@eeacms/volto-columns-block": "^4.0.0"
4658
}
4759
```
4860

61+
* If not, create one:
62+
63+
```
64+
npm install -g yo @plone/generator-volto
65+
yo @plone/volto my-volto-project --addon @eeacms/volto-columns-block
66+
cd my-volto-project
67+
```
68+
4969
1. Install new add-ons and restart Volto:
5070

5171
```
52-
$ yarn
53-
$ yarn start
72+
yarn
73+
yarn start
5474
```
5575

5676
1. Go to http://localhost:3000
@@ -71,3 +91,10 @@ See [LICENSE.md](https://github.com/eea/volto-columns-block/blob/master/LICENSE.
7191
## Funding
7292

7393
[European Environment Agency (EU)](http://eea.europa.eu)
94+
rved.
95+
96+
See [LICENSE.md](https://github.com/eea/volto-columns-block/blob/master/LICENSE.md) for details.
97+
98+
## Funding
99+
100+
[European Environment Agency (EU)](http://eea.europa.eu)

bootstrap

Lines changed: 14 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -1,5 +1,6 @@
11
const path = require('path');
22
const fs = require('fs');
3+
const ejs = require('ejs');
34

45
const currentDir = path.basename(process.cwd());
56

@@ -8,13 +9,23 @@ const bootstrap = function (ofile) {
89
if (err) {
910
return console.log(err);
1011
}
11-
var result = data.replace(/volto-addon-template/g, currentDir);
12-
13-
fs.writeFile(ofile, result, 'utf8', function (err) {
12+
const result = ejs.render(data, {
13+
addonName: `@eeacms/${currentDir}`,
14+
name: currentDir
15+
});
16+
const output = ofile.replace('.tpl', '');
17+
fs.writeFile(output, result, 'utf8', function (err) {
1418
if (err) {
1519
return console.log(err);
1620
}
1721
});
22+
if (ofile.includes('.tpl')) {
23+
fs.unlink(ofile, (err) => {
24+
if (err) {
25+
return console.error(err);
26+
}
27+
});
28+
}
1829
});
1930
}
2031

0 commit comments

Comments
 (0)