README.md
author ymh <ymh.work@gmail.com>
Tue, 23 Apr 2019 20:24:02 +0200
changeset 2 8bfef8029c17
parent 0 800e4a6ab128
child 5 3b60692effa9
permissions -rw-r--r--
Correct README and add missing wp-config file
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
0
800e4a6ab128 First commit
ymh <ymh.work@gmail.com>
parents:
diff changeset
     1
# Recherchecontributive.org Website
800e4a6ab128 First commit
ymh <ymh.work@gmail.com>
parents:
diff changeset
     2
800e4a6ab128 First commit
ymh <ymh.work@gmail.com>
parents:
diff changeset
     3
This project is the website for recherchecontributive.org.
800e4a6ab128 First commit
ymh <ymh.work@gmail.com>
parents:
diff changeset
     4
800e4a6ab128 First commit
ymh <ymh.work@gmail.com>
parents:
diff changeset
     5
## Getting Started
800e4a6ab128 First commit
ymh <ymh.work@gmail.com>
parents:
diff changeset
     6
800e4a6ab128 First commit
ymh <ymh.work@gmail.com>
parents:
diff changeset
     7
These instructions will get you a copy of the project up and running on your local machine for development and testing purposes. See deployment for notes on how to deploy the project on a live system.
800e4a6ab128 First commit
ymh <ymh.work@gmail.com>
parents:
diff changeset
     8
800e4a6ab128 First commit
ymh <ymh.work@gmail.com>
parents:
diff changeset
     9
### Prerequisites
800e4a6ab128 First commit
ymh <ymh.work@gmail.com>
parents:
diff changeset
    10
800e4a6ab128 First commit
ymh <ymh.work@gmail.com>
parents:
diff changeset
    11
What things you need to install the software and how to install them
800e4a6ab128 First commit
ymh <ymh.work@gmail.com>
parents:
diff changeset
    12
800e4a6ab128 First commit
ymh <ymh.work@gmail.com>
parents:
diff changeset
    13
  - docker
800e4a6ab128 First commit
ymh <ymh.work@gmail.com>
parents:
diff changeset
    14
  - docker-compose
800e4a6ab128 First commit
ymh <ymh.work@gmail.com>
parents:
diff changeset
    15
  - A code editor
800e4a6ab128 First commit
ymh <ymh.work@gmail.com>
parents:
diff changeset
    16
800e4a6ab128 First commit
ymh <ymh.work@gmail.com>
parents:
diff changeset
    17
800e4a6ab128 First commit
ymh <ymh.work@gmail.com>
parents:
diff changeset
    18
### Installing
800e4a6ab128 First commit
ymh <ymh.work@gmail.com>
parents:
diff changeset
    19
2
8bfef8029c17 Correct README and add missing wp-config file
ymh <ymh.work@gmail.com>
parents: 0
diff changeset
    20
Build docker images:
8bfef8029c17 Correct README and add missing wp-config file
ymh <ymh.work@gmail.com>
parents: 0
diff changeset
    21
8bfef8029c17 Correct README and add missing wp-config file
ymh <ymh.work@gmail.com>
parents: 0
diff changeset
    22
```
8bfef8029c17 Correct README and add missing wp-config file
ymh <ymh.work@gmail.com>
parents: 0
diff changeset
    23
$ docker-compose build
8bfef8029c17 Correct README and add missing wp-config file
ymh <ymh.work@gmail.com>
parents: 0
diff changeset
    24
```
8bfef8029c17 Correct README and add missing wp-config file
ymh <ymh.work@gmail.com>
parents: 0
diff changeset
    25
0
800e4a6ab128 First commit
ymh <ymh.work@gmail.com>
parents:
diff changeset
    26
Launch the project
800e4a6ab128 First commit
ymh <ymh.work@gmail.com>
parents:
diff changeset
    27
800e4a6ab128 First commit
ymh <ymh.work@gmail.com>
parents:
diff changeset
    28
```
800e4a6ab128 First commit
ymh <ymh.work@gmail.com>
parents:
diff changeset
    29
$ docker-compose up
800e4a6ab128 First commit
ymh <ymh.work@gmail.com>
parents:
diff changeset
    30
```
800e4a6ab128 First commit
ymh <ymh.work@gmail.com>
parents:
diff changeset
    31
or
800e4a6ab128 First commit
ymh <ymh.work@gmail.com>
parents:
diff changeset
    32
```
800e4a6ab128 First commit
ymh <ymh.work@gmail.com>
parents:
diff changeset
    33
$ docker-compose up -d
800e4a6ab128 First commit
ymh <ymh.work@gmail.com>
parents:
diff changeset
    34
```
800e4a6ab128 First commit
ymh <ymh.work@gmail.com>
parents:
diff changeset
    35
800e4a6ab128 First commit
ymh <ymh.work@gmail.com>
parents:
diff changeset
    36
import data.
800e4a6ab128 First commit
ymh <ymh.work@gmail.com>
parents:
diff changeset
    37
800e4a6ab128 First commit
ymh <ymh.work@gmail.com>
parents:
diff changeset
    38
```
800e4a6ab128 First commit
ymh <ymh.work@gmail.com>
parents:
diff changeset
    39
$ docker-compose exec -T wp /var/www/html/vendor/bin/wp --allow-root db import - < /path/to/recherchecontributive_dbase.sql
800e4a6ab128 First commit
ymh <ymh.work@gmail.com>
parents:
diff changeset
    40
```
800e4a6ab128 First commit
ymh <ymh.work@gmail.com>
parents:
diff changeset
    41
800e4a6ab128 First commit
ymh <ymh.work@gmail.com>
parents:
diff changeset
    42
Replace strings in database:
800e4a6ab128 First commit
ymh <ymh.work@gmail.com>
parents:
diff changeset
    43
800e4a6ab128 First commit
ymh <ymh.work@gmail.com>
parents:
diff changeset
    44
```
800e4a6ab128 First commit
ymh <ymh.work@gmail.com>
parents:
diff changeset
    45
docker-compose exec wp /var/www/html/vendor/bin/wp --allow-root search-replace https://recherchecontributive.org http://localhost:8080
800e4a6ab128 First commit
ymh <ymh.work@gmail.com>
parents:
diff changeset
    46
```
800e4a6ab128 First commit
ymh <ymh.work@gmail.com>
parents:
diff changeset
    47
800e4a6ab128 First commit
ymh <ymh.work@gmail.com>
parents:
diff changeset
    48
Import media files:
800e4a6ab128 First commit
ymh <ymh.work@gmail.com>
parents:
diff changeset
    49
```
800e4a6ab128 First commit
ymh <ymh.work@gmail.com>
parents:
diff changeset
    50
$ tar -C src/web/app/ zxf /path/to/recherchecontributive_media.tar.gz 
800e4a6ab128 First commit
ymh <ymh.work@gmail.com>
parents:
diff changeset
    51
```
800e4a6ab128 First commit
ymh <ymh.work@gmail.com>
parents:
diff changeset
    52
800e4a6ab128 First commit
ymh <ymh.work@gmail.com>
parents:
diff changeset
    53
Navigate to http://localhost:8080.
800e4a6ab128 First commit
ymh <ymh.work@gmail.com>
parents:
diff changeset
    54
800e4a6ab128 First commit
ymh <ymh.work@gmail.com>
parents:
diff changeset
    55
## Deployment
800e4a6ab128 First commit
ymh <ymh.work@gmail.com>
parents:
diff changeset
    56
800e4a6ab128 First commit
ymh <ymh.work@gmail.com>
parents:
diff changeset
    57
TODO...
800e4a6ab128 First commit
ymh <ymh.work@gmail.com>
parents:
diff changeset
    58
800e4a6ab128 First commit
ymh <ymh.work@gmail.com>
parents:
diff changeset
    59
## Built With
800e4a6ab128 First commit
ymh <ymh.work@gmail.com>
parents:
diff changeset
    60
800e4a6ab128 First commit
ymh <ymh.work@gmail.com>
parents:
diff changeset
    61
* [Wordpress](https://wordpress.org/) - The CMS used
800e4a6ab128 First commit
ymh <ymh.work@gmail.com>
parents:
diff changeset
    62
800e4a6ab128 First commit
ymh <ymh.work@gmail.com>
parents:
diff changeset
    63
## Versioning
800e4a6ab128 First commit
ymh <ymh.work@gmail.com>
parents:
diff changeset
    64
800e4a6ab128 First commit
ymh <ymh.work@gmail.com>
parents:
diff changeset
    65
We use [SemVer](http://semver.org/) for versioning. For the versions available, see the [tags on this repository](https://www.iri.centrepompidou.fr/dev/hg/recherchecontributive/tags). 
800e4a6ab128 First commit
ymh <ymh.work@gmail.com>
parents:
diff changeset
    66
800e4a6ab128 First commit
ymh <ymh.work@gmail.com>
parents:
diff changeset
    67
## Authors
800e4a6ab128 First commit
ymh <ymh.work@gmail.com>
parents:
diff changeset
    68
800e4a6ab128 First commit
ymh <ymh.work@gmail.com>
parents:
diff changeset
    69
* **Yves-Marie Haussonne** - *Initial work*
800e4a6ab128 First commit
ymh <ymh.work@gmail.com>
parents:
diff changeset
    70
800e4a6ab128 First commit
ymh <ymh.work@gmail.com>
parents:
diff changeset
    71
## License
800e4a6ab128 First commit
ymh <ymh.work@gmail.com>
parents:
diff changeset
    72
800e4a6ab128 First commit
ymh <ymh.work@gmail.com>
parents:
diff changeset
    73
This project is licensed under the CecCill License - see the [LICENSE.md](LICENSE.md) file for details
800e4a6ab128 First commit
ymh <ymh.work@gmail.com>
parents:
diff changeset
    74
800e4a6ab128 First commit
ymh <ymh.work@gmail.com>
parents:
diff changeset
    75
## Acknowledgments
800e4a6ab128 First commit
ymh <ymh.work@gmail.com>
parents:
diff changeset
    76
800e4a6ab128 First commit
ymh <ymh.work@gmail.com>
parents:
diff changeset
    77
* Hat tip to anyone whose code was used
800e4a6ab128 First commit
ymh <ymh.work@gmail.com>
parents:
diff changeset
    78
* Wordpress: https://wordpress.org/
800e4a6ab128 First commit
ymh <ymh.work@gmail.com>
parents:
diff changeset
    79
* Bedrock: https://roots.io/bedrock
800e4a6ab128 First commit
ymh <ymh.work@gmail.com>
parents:
diff changeset
    80
* Docker for loacl wordpress development: https://urre.me/writings/docker-for-local-wordpress-development/
800e4a6ab128 First commit
ymh <ymh.work@gmail.com>
parents:
diff changeset
    81
800e4a6ab128 First commit
ymh <ymh.work@gmail.com>
parents:
diff changeset
    82
800e4a6ab128 First commit
ymh <ymh.work@gmail.com>
parents:
diff changeset
    83
## Data management
800e4a6ab128 First commit
ymh <ymh.work@gmail.com>
parents:
diff changeset
    84
800e4a6ab128 First commit
ymh <ymh.work@gmail.com>
parents:
diff changeset
    85
800e4a6ab128 First commit
ymh <ymh.work@gmail.com>
parents:
diff changeset
    86
### Export database
800e4a6ab128 First commit
ymh <ymh.work@gmail.com>
parents:
diff changeset
    87
```
800e4a6ab128 First commit
ymh <ymh.work@gmail.com>
parents:
diff changeset
    88
$ docker-compose exec wp /var/www/html/vendor/bin/wp --allow-root db export --add-drop-table - > recherchecontributive_dbase_2019-04-19.sql
800e4a6ab128 First commit
ymh <ymh.work@gmail.com>
parents:
diff changeset
    89
```
800e4a6ab128 First commit
ymh <ymh.work@gmail.com>
parents:
diff changeset
    90
800e4a6ab128 First commit
ymh <ymh.work@gmail.com>
parents:
diff changeset
    91
### Export media
800e4a6ab128 First commit
ymh <ymh.work@gmail.com>
parents:
diff changeset
    92
```
800e4a6ab128 First commit
ymh <ymh.work@gmail.com>
parents:
diff changeset
    93
$ tar zcf recherchecontributive_media_2019-04-19.tar.gz -C src/web/app/ uploads
800e4a6ab128 First commit
ymh <ymh.work@gmail.com>
parents:
diff changeset
    94
```
800e4a6ab128 First commit
ymh <ymh.work@gmail.com>
parents:
diff changeset
    95
800e4a6ab128 First commit
ymh <ymh.work@gmail.com>
parents:
diff changeset
    96
### Import database
800e4a6ab128 First commit
ymh <ymh.work@gmail.com>
parents:
diff changeset
    97
800e4a6ab128 First commit
ymh <ymh.work@gmail.com>
parents:
diff changeset
    98
```
800e4a6ab128 First commit
ymh <ymh.work@gmail.com>
parents:
diff changeset
    99
$ docker-compose exec -T wp /var/www/html/vendor/bin/wp --allow-root db import - < recherchecontributive_dbase_2019-04-19.sql
800e4a6ab128 First commit
ymh <ymh.work@gmail.com>
parents:
diff changeset
   100
```
800e4a6ab128 First commit
ymh <ymh.work@gmail.com>
parents:
diff changeset
   101
800e4a6ab128 First commit
ymh <ymh.work@gmail.com>
parents:
diff changeset
   102
If needed do a search replace after this to update the site urls:
800e4a6ab128 First commit
ymh <ymh.work@gmail.com>
parents:
diff changeset
   103
800e4a6ab128 First commit
ymh <ymh.work@gmail.com>
parents:
diff changeset
   104
```
800e4a6ab128 First commit
ymh <ymh.work@gmail.com>
parents:
diff changeset
   105
$ docker-compose exec wp /var/www/html/vendor/bin/wp --allow-root search-replace https://recherchecontributive.org http://localhost:8080
800e4a6ab128 First commit
ymh <ymh.work@gmail.com>
parents:
diff changeset
   106
```
800e4a6ab128 First commit
ymh <ymh.work@gmail.com>
parents:
diff changeset
   107
800e4a6ab128 First commit
ymh <ymh.work@gmail.com>
parents:
diff changeset
   108
Or change the administration password
800e4a6ab128 First commit
ymh <ymh.work@gmail.com>
parents:
diff changeset
   109
```
800e4a6ab128 First commit
ymh <ymh.work@gmail.com>
parents:
diff changeset
   110
$ docker-compose exec -T wp /var/www/html/vendor/bin/wp --allow-root user update admin --prompt=user_pass
800e4a6ab128 First commit
ymh <ymh.work@gmail.com>
parents:
diff changeset
   111
```
800e4a6ab128 First commit
ymh <ymh.work@gmail.com>
parents:
diff changeset
   112