doccano在win7下安装与二次开发

 

一、部署

1、获取安装文件

         #原始项目文件      

         https://gitee.com/lduml/doccano/repository/archive/master.zip

         #汉化后的项目文件（推荐使用这个）

         https://github.com/moon-hotel/doccano.git

解压下载后的文件并放在C盘根目录下（C:\doccano-moonhotel\doccano），防止后续test出错。

2、使用pycharm打开目录，并创建虚拟开发环境

         2.1 虚拟环境python版本：Python 3.6

注意：务必建立一个python3.6版本的虚拟环境，因为以下Python依赖包都必须建立在此基础上。

                   conda create -n docca python=3.6

                   conda activate docca

                  

                  附一下其他的conda命令：

                   conda remove -n xxxx --all   //创建xxxx虚拟环境

                   conda update -n base conda        #update最新版本的conda

                   conda create -n xxxx python=3.5   #创建python3.5的xxxx虚拟环境

                   conda activate xxxx               #开启xxxx环境

                   conda deactivate                  #关闭环境

                   conda env list                    #显示所有的虚拟环境

                   conda info --envs                 #显示所有的虚拟环境

                 

         2.2 安装Python依赖包

                    #修改C:\doccano-moonhotel\doccano\requirements.txt文件

                   pyjwt==1.6.1

               

                   # 安装插件（后缀是为了加速下载）

         (docca) C:\doccano-moonhotel\doccano>    

pip --default-timeout=100 install -r requirements.txt -i http://mirrors.aliyun.com/pypi/simple/ --trusted-host mirrors.aliyun.com

                  

                   #初始化项目

                            python manage.py makemigrations

                            python manage.py migrate

                   # 创建管理员用户密码（用户名和密码：soonther/password）

               python manage.py create_admin --noinput --username "soonther" --email "[email protected]" --password "password"

                                     Superuser created successfully.

                                     Setting password for User admin.

 

                   # 初始化项目角色

                   python manage.py create_roles

                                     Role created successfully "project_admin"

                                     Role created successfully "annotator"

                                     Role created successfully "annotation_approver"

                   # 测试项目

                    python manage.py test server.tests （测试服务端）

                    python manage.py test api.tests （测试接口）

                    python manage.py test authentification.tests（测试鉴权）

 

                  #启动项目（注意，现在启动后还不能访问，因为前段还没部署）

                            python manage.py runserver

                        

         2.3 安装nodejs

                  

npm: nodejs 下的包管理器，是属于nodejs安装包的一部分。因此只需要下载安装nodejs就OK，安装完成了nodejs后npm也就自动安装完成了

 

webpack: 它主要用途是通过CommonJS 的语法把所有浏览器端需要发布的静态资源作相应的准备，比如资源的合并和打包。

 

vue-cli: 用户生成Vue工程模板。（帮你快速开始一个vue的项目，也就是给你一套vue的结构，包含基础的依赖库，只需要npm install 就可以安装。

 

安装到D：根目录下，针对win7版本安装nodejs V12版本

                   https://nodejs.org/download/release/latest-v12.x/

                  

                   具体步骤参考：

1. Doccano的下载，安装，配置，包含npm的下载和安装教程https://blog.csdn.net/liuzhiwei_Sta/article/details/105643135?ops_request_misc=%257B%2522request%255Fid%2522%253A%2522162207535316780255233493%2522%252C%2522scm%2522%253A%252220140713.130102334.pc%255Fall.%2522%257D&request_id=162207535316780255233493&biz_id=0&utm_medium=distribute.pc_search_result.none-task-blog-2~all~first_rank_v2~rank_v29-4-105643135.first_rank_v2_pc_rank_v29&utm_term=win7%E4%B8%8B%E5%AE%89%E8%A3%85doccano
2. doccano 标注工具 全网最全安装部署采坑https://blog.csdn.net/lihangxiaoji/article/details/106827757
3. 一站式语料标注工具（你值得拥有）https://mp.weixin.qq.com/s?__biz=MzAwNjU0NjA3Ng==&mid=2247487635&idx=1&sn=6cb73bccfdef2545d83afc3d7c583eb5&chksm=9b0ae760ac7d6e7695cac8d30dfebe3e62a0b3a59b80dbed8d96ad99c1b2bf23469861b0a7f7&token=466293760&lang=zh_CN#rd
4.   记录下遇到的一些问题解决办法：

                   1) 使用WIN+R打开运行的小窗口，然后输入.后点击确定，这样就进入了你的C盘的系统用户目录；

                   2) 进入了系统用户目录后，然后就可以找到文件名为 .npmrc这个文件，打开这个文件后，然后就可以看到prefix=xxxx和cache=xxxx这两个属性，于是就可以将xxxx中的内容改成你系统中实际配置的路径就可以了。

                   npm config set prefix D:\nodejs\node_global

                   npm config set cache D:\nodejs\node_cache

                  

                   prefix=D:\nodejs\node_global

                   cache=D:\nodejs\node_cache

                  

                   3)使用vue init webpack my-App 创建项目回车时显示

                            Command vue init requires a global addon to be installed.

                            Please run yarn global add @vue/cli-init and try again.

                   解决方法：npm install -g @vue/cli-init

 

         2.4 使用cmd，进入前端目录，本地部署前端

                   前端目录： ***\doccano\app\server\static

                   # 初始化前端项目

                            npm install

                            （必要时使用：npm install -g @vue/cli-init）

                   #　编译前端项目

                            npm run build

                   #　启动前端项目

                            npm start

 

二、二次开发

 参考资料

1. 文本数据标注工具Doccano https://blog.csdn.net/weixin_40547993/article/details/102726832
2. doccano标注后的序列标注任务数据转录为BIO形式https://blog.csdn.net/broccoli2/article/details/112008692
3. Doccano标注系统安装与二次开发https://blog.csdn.net/u013008795/article/details/106804737?utm_term=doccano&utm_medium=distribute.pc_aggpage_search_result.none-task-blog-2~all~sobaiduweb~default-2-106804737&spm=3001.4430