You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.

55 lines
3.9 KiB

  1. ## I can't install doccano.
  2. Following list is ordered by from easy to hard. If you are not familiar with Python development, please consider easy setup.
  3. 1. [One click deployment to Cloud Service.](https://github.com/doccano/doccano#deployment)
  4. * Only you have to do is create an account. Especially [Heroku](https://www.heroku.com/home) does not require your credit card (if free plan).
  5. * [![Deploy to Azure](https://azuredeploy.net/deploybutton.svg)](https://portal.azure.com/#create/Microsoft.Template/uri/https%3A%2F%2Fraw.githubusercontent.com%2Fdoccano%2Fdoccano%2Fmaster%2Fazuredeploy.json)
  6. * [![Deploy](https://www.herokucdn.com/deploy/button.svg)](https://heroku.com/deploy)
  7. * [![AWS CloudFormation Launch Stack SVG Button](https://cdn.rawgit.com/buildkite/cloudformation-launch-stack-button-svg/master/launch-stack.svg)](https://us-east-1.console.aws.amazon.com/cloudformation/home?region=us-east-1#/stacks/create/review?templateURL=https://s3-external-1.amazonaws.com/cf-templates-10vry9l3mp71r-us-east-1/20190732wl-new.templatexloywxxyimi&stackName=doccano)
  8. * > Notice: (1) EC2 KeyPair cannot be created automatically, so make sure you have an existing EC2 KeyPair in one region. Or [create one yourself](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/ec2-key-pairs.html#having-ec2-create-your-key-pair). (2) If you want to access doccano via HTTPS in AWS, here is an [instruction](https://github.com/doccano/doccano/wiki/HTTPS-setting-for-doccano-in-AWS).
  9. 2. [Use Docker](https://docs.docker.com/install/)
  10. * Docker doesn't bother you by the OS, Python version, etc problems. Because an environment for application is packed as a container.
  11. * Get doccano's image: `docker pull doccano/doccano`
  12. * Create & Run doccano container: `docker run -d --name doccano -p 8000:80 doccano/doccano`
  13. * Create a user: `docker exec doccano tools/create-admin.sh "admin" "admin@example.com" "password"`
  14. * Stop doccano container: `docker stop doccano`
  15. * Re-Launch doccano container: `docker start doccano`
  16. 3. Install from source
  17. * **I want to remember you that this is the hardest setup way. You have to install Python/Node.js and type many commands.**
  18. * [Install Python](https://www.python.org/downloads/)
  19. * [Install Node.js](https://nodejs.org/en/download/)
  20. * Get the source code of doccano: `git clone https://github.com/doccano/doccano.git`
  21. * Move to doccano directory: `cd doccano`
  22. * Create environment for doccano: `virtualenv venv`
  23. * Activate environment: `source venv/bin/activate`
  24. * Install required packages: `pip install -r requirements.txt`
  25. * Move server directory: `cd app/server`
  26. * Build frontend library: `npm install`
  27. * Build frontend source code: `npm run build`
  28. * Back to server directory: `cd ../`
  29. * Initialize doccano: `python manage.py migrate`
  30. * Create user: `python manage.py createsuperuser`
  31. * Run doccano: `python manage.py runserver`
  32. * Stop doccano: Ctrl+C
  33. * Re-Launch doccano: `python manage.py runserver` (Confirm you are at `app/server` directory and environment is active).
  34. ## I can't upload my data.
  35. Please check the following list.
  36. - File encoding: `UTF-8` is appropriate.
  37. - Filename: alphabetic file name is suitable.
  38. - File format selection: File format radio button should be selected properly.
  39. - When you are using JSON/JSONL: Confirm JSON data is valid.
  40. - You can use [JSONLint](https://jsonlint.com/) or some other tool (when JSONL, pick one data and check it).
  41. - When you are using CSV: Confirm CSV data is valid.
  42. - You can use Excel or some tools that have import CSV feature.
  43. - Lack of line: Data file should not contain blank line.
  44. - Lack of field: Data file should not contain blank field.
  45. **You don't need your real & all data to validate file format. The picked data & masked data is suitable if your data is large or secret.**
  46. ## I want to add annotators.
  47. * You can create other annotators by [Django Admin site](https://djangobook.com/django-admin-site/).