mirror of
https://github.com/pinry/pinry.git
synced 2026-01-16 12:12:06 +01:00
Refactor: Move development parts to pinry-doc instead of README.md
This commit is contained in:
57
README.md
57
README.md
@@ -4,7 +4,7 @@ The open-source core of Pinry, a tiling image board system for people
|
|||||||
who want to save, tag, and share images, videos and webpages in an easy
|
who want to save, tag, and share images, videos and webpages in an easy
|
||||||
to skim through format.
|
to skim through format.
|
||||||
|
|
||||||
For more information visit [getpinry.com](https://getpinry.com).
|
For more information ( screenshots and document ) visit [getpinry.com](https://getpinry.com).
|
||||||
|
|
||||||
|
|
||||||
## Features
|
## Features
|
||||||
@@ -13,8 +13,9 @@ For more information visit [getpinry.com](https://getpinry.com).
|
|||||||
- Tagging system for Pins
|
- Tagging system for Pins
|
||||||
- Browser Extensions
|
- Browser Extensions
|
||||||
- Multi-user support
|
- Multi-user support
|
||||||
- Both public and private boards
|
|
||||||
- Works well with docker
|
- Works well with docker
|
||||||
|
- Both public and private boards (add @2020.02.11)
|
||||||
|
- Search by tags / Search boards with name (add @2020.02.14)
|
||||||
|
|
||||||
## Install with Docker
|
## Install with Docker
|
||||||
See our full documentation at [https://docs.getpinry.com/install-with-docker/](https://docs.getpinry.com/install-with-docker/)
|
See our full documentation at [https://docs.getpinry.com/install-with-docker/](https://docs.getpinry.com/install-with-docker/)
|
||||||
@@ -28,58 +29,6 @@ See our full documentation at [https://docs.getpinry.com/development/](https://d
|
|||||||
|
|
||||||
See our full documentation at [https://docs.getpinry.com/development/](https://docs.getpinry.com/development/)
|
See our full documentation at [https://docs.getpinry.com/development/](https://docs.getpinry.com/development/)
|
||||||
|
|
||||||
|
|
||||||
## Testing
|
|
||||||
|
|
||||||
We have many tests built into Pinry to ensure that changes don't break
|
|
||||||
anything. If you are live dangerously and have cutting edge new Pinry
|
|
||||||
features first you can use our master branch for your own instance. We
|
|
||||||
recommend using our tags/versions though.
|
|
||||||
|
|
||||||
To run Pinry's tests inside the Pinry repo run:
|
|
||||||
|
|
||||||
pipenv install --dev --three
|
|
||||||
pipenv run python manage.py test
|
|
||||||
|
|
||||||
|
|
||||||
# Docker
|
|
||||||
|
|
||||||
Follow the steps below to install Pinry locally or on any server. This
|
|
||||||
process installs the minimal requirements to run Pinry. For development
|
|
||||||
requirements and procedures, see testing above.
|
|
||||||
|
|
||||||
Current docker configuration will just mount source code directory to
|
|
||||||
docker app directory and run any codes existed in current git branch,
|
|
||||||
you may also add "local_settings.py" to customize settings without
|
|
||||||
changing settings file in `pinry/settings`.
|
|
||||||
|
|
||||||
- Install the requirements:
|
|
||||||
- Docker
|
|
||||||
- Docker Compose
|
|
||||||
|
|
||||||
- Set any custom configuration options you need and run::
|
|
||||||
|
|
||||||
cp docker-compose.example.yml docker-compose.yml
|
|
||||||
\# edit docker-compose.yml and change the secret-key,
|
|
||||||
\# don't forget to backup this config file.
|
|
||||||
\# You should build frontend first
|
|
||||||
docker-compose up build_frontend
|
|
||||||
\# then start the backend server
|
|
||||||
docker-compose up -d web
|
|
||||||
|
|
||||||
- If you want to run Pinry with current user in docker::
|
|
||||||
|
|
||||||
./start_docker_with_current_user.sh [-d]
|
|
||||||
|
|
||||||
- Bootstrap the database(optional)::
|
|
||||||
|
|
||||||
docker-compose exec web python3 manage.py migrate --settings=pinry.settings.docker
|
|
||||||
|
|
||||||
|
|
||||||
**Note** : No static file server configured, your should configure nginx or other server to serve
|
|
||||||
static files from `./static`(as path `/static`) and `./pinry-spa/dist` (as html root `/`)
|
|
||||||
|
|
||||||
|
|
||||||
## Contributors
|
## Contributors
|
||||||
|
|
||||||
The core contributors for Pinry have been/currently are:
|
The core contributors for Pinry have been/currently are:
|
||||||
|
|||||||
@@ -31,3 +31,52 @@ backend:
|
|||||||
And from another terminal:
|
And from another terminal:
|
||||||
|
|
||||||
cd pinry-spa; yarn serve
|
cd pinry-spa; yarn serve
|
||||||
|
|
||||||
|
|
||||||
|
## Testing
|
||||||
|
|
||||||
|
We have many tests built into Pinry to ensure that changes don't break
|
||||||
|
anything. If you are live dangerously and have cutting edge new Pinry
|
||||||
|
features first you can use our master branch for your own instance. We
|
||||||
|
recommend using our tags/versions though.
|
||||||
|
|
||||||
|
To run Pinry's tests inside the Pinry repo run:
|
||||||
|
|
||||||
|
pipenv run python manage.py test
|
||||||
|
|
||||||
|
# Docker
|
||||||
|
|
||||||
|
Follow the steps below to install Pinry locally or on any server. This
|
||||||
|
process installs the minimal requirements to run Pinry. For development
|
||||||
|
requirements and procedures, see testing above.
|
||||||
|
|
||||||
|
Current docker configuration will just mount source code directory to
|
||||||
|
docker app directory and run any codes existed in current git branch,
|
||||||
|
you may also add "local_settings.py" to customize settings without
|
||||||
|
changing settings file in `pinry/settings`.
|
||||||
|
|
||||||
|
- Install the requirements:
|
||||||
|
- Docker
|
||||||
|
- Docker Compose
|
||||||
|
|
||||||
|
- Set any custom configuration options you need and run::
|
||||||
|
|
||||||
|
cp docker-compose.example.yml docker-compose.yml
|
||||||
|
\# edit docker-compose.yml and change the secret-key,
|
||||||
|
\# don't forget to backup this config file.
|
||||||
|
\# You should build frontend first
|
||||||
|
docker-compose up build_frontend
|
||||||
|
\# then start the backend server
|
||||||
|
docker-compose up -d web
|
||||||
|
|
||||||
|
- If you want to run Pinry with current user in docker::
|
||||||
|
|
||||||
|
./start_docker_with_current_user.sh [-d]
|
||||||
|
|
||||||
|
- Bootstrap the database(optional)::
|
||||||
|
|
||||||
|
docker-compose exec web python3 manage.py migrate --settings=pinry.settings.docker
|
||||||
|
|
||||||
|
|
||||||
|
**Note** : No static file server configured, your should configure nginx or other server to serve
|
||||||
|
static files from `./static`(as path `/static`) and `./pinry-spa/dist` (as html root `/`)
|
||||||
|
|||||||
@@ -17,7 +17,7 @@ nav:
|
|||||||
- Screenshots: 'screenshots.md'
|
- Screenshots: 'screenshots.md'
|
||||||
- Extensions: 'extensions.md'
|
- Extensions: 'extensions.md'
|
||||||
- Theories: 'theories.md'
|
- Theories: 'theories.md'
|
||||||
- InstallWithDocker: 'install-with-docker.md'
|
- Install with Docker: 'install-with-docker.md'
|
||||||
- Development: 'development.md'
|
- Development: 'development.md'
|
||||||
- Docs: 'docs.md'
|
- Docs: 'docs.md'
|
||||||
- Passwords: 'passwords.md'
|
- Passwords: 'passwords.md'
|
||||||
|
|||||||
Reference in New Issue
Block a user