行业文库
行业文库

INDUSTRY NEWS

首页 > 行业文库 > 正文
大神解读在Windows或Liunx系统上使用ONLYOFFICE协作编辑文档开发
发布时间:2020-03-25 23:41:12
1、说明——可以加我qq6277979沟通。
 
ONLYOFFICE Document Server提供文档协作的服务功能,支持Word,Excel和PowerPoint以及国产WPS的协作。但是这里告诉我们,需要进行文档管理和存储的二次开发。它api里现成的开发好的文档管理平台,有java,node.js,PHP等,可能不具备权限功能吧。
 
Please note, that ONLYOFFICE Document Server includes the documenteditor, document editing service, document command service and documentconversion service.The document manager and documentstorage service areeither included to Community Server or must be implemented by the softwareintegrators who use ONLYOFFICE Document Server on their own server.
 
它自己的ONLYOFFICE/CommunityServer就是管理文件用的,是一个庞大的项目管理系统。
 
ONLYOFFICE CommunityServer is a free open source collaborative system developed to managedocuments, projects, customer relationship and email correspondence, all in oneplace.
 
Nextcloud,可道云等云盘系统也支持ONLYOFFICE协作服务,我用Golang语言开发的EngineerCMS来实现ONLYOFFICE的文档管理和存储,调用ONLYOFFICE Document Server服务来进行文档协作,权限完全按照官方的community。
 
协作的好处在于少了来回传递文档,少了汇总的负责人,特别是十多人合作编写文档的时候,汇总的工作量大,容易出错,任何人稍微修改一点,都要重新传递整个文档,汇总后还要再次发给大家核对……。
 
协作也可以应用于校审流程,校核和审查直接在文档上修改即可。
 
其他如月报的合作,工作任务表的更新:每个人的任务表要随时更新,除非用专业的任务管理软件,否则用Excel表格的话,也是要负责人汇总更新表格,应付领导检查。
 
会议纪要写好了,把链接发给大家,有意见直接在上面修改补充。
 
投标要多人协作的话,用这个平台也是不错的。
 
报表的汇总。
 
市场上协作的平台不下几十种,著名的如石墨,一起写,腾讯文档协作TIM,Google Doc,office365,office online等,基本按人月收费,免费的有人数限制,并且想自己部署在局域网的话也不大可能。你的文档上传给他们或许有诸多不便呢。比如银行的报表,嘿嘿,你懂的。
 
所以,我就在ONLYOFFICE Document Server基础上用Golang语言开发了文档管理和存储功能,方便大家免费无限制任意部署的需求。
 
总的思路就是比如在局域网的某台windows(或linux)电脑上安装docker容器来运行ONLYOFFICE Document Server,然后运行EngineerCMS来调用ONLYOFFICE Document Server的服务。在云服务器上部署也是一个道理。
 
ONLYOFFICE目前存在的缺点:汉字输入不是很方便,就是当输入符号的时候,它会重复将前面的汉字又输进去一次:解决办法,在设置里勾选象形文字(5.1.2新版已经解决这个问题);Excel表格里的文字格式没有删除线、上下标之类,文本框中的文字有这些格式,Word中也有;QQ拼音输入法按空格不能输出汉字,(5.1.2新版已经解决这个问题)搜狗输入法可以;字体/样式选择里显示的是英文,不是汉字(用ps修改一下图片即可);打开文档默认文字检查都是打开的,新版5.1.2版支持word目录,但没有文档结构(免费版不支持文档结构图,需要另外开发,已经有解决方案)。但瑕不掩瑜,它的功能还是很强大的,而且随着版本的更替,会解决这些问题的。
 
2、安装准备
 
如果是局域网,部署的电脑拥有固定ip(下文叫宿主机,切记)。电脑能打开cup的虚拟功能。如果部署到云主机,道理是一样的。
 
环境是win7以上,win10以下。Win10区别就是安装的docker软件不同而已,win10不需要设置端口转发。
 
linux就更简单了。
 
第一步:确定电脑打开了cpu虚拟打开。https://jingyan.baidu.com/article/22fe7ced3b4c003002617f17.html
 
第二步:下载和安装docker toolbox,默认安装即可。下载地址http://get.daocloud.io/,下载支持旧版windows的docker toolbox,win10就直接下载docker了。
 
第三步:启动docker后在里面拉取Onlyoffice Document Server 的Docker镜像
 
3、拉取ONLYOFFICE Document Server 的Docker镜像
 
拉取镜像:启动docker,在里面输入命令docker pull onlyoffice/documentserver
 
(注意:docker要断网启动!!切记,启动后再联网。如果已经运行了onlyoffice document server 下次开机,重新启动docker后,不需要在运行onlyoffice的)
 
可以用我做好的镜像导入(离线包导入),已经设置好了字体,修正了几个翻译错误,可以省略第5步,从第4步直接跳过第5步到第6步。
 
用docker load < fei6onlyoffice5.4.2.tar命令。
 
建议用离线的,
 
(Administrator@604TFALNDKDKJWCMINGW64 ~
 
$ dockerexport -o onlyoffice-`date +%Y%m%d`.tar 6df)
 
$ docker import  onlyoffice-20180220-import.tar onlyoffice/documentserver——import命令是错误的。
 
离线的包在我的网盘中:https://pan.baidu.com/s/1gf0ucuR,离线包有5个:
 
第一个是onlyoffice_load.tar,替换好了字体,修正了几个翻译错误,是用commit命令生成新的包后save导出的。
 
第二个是onlyoffice-20180220-import.tar,这个包虽然里面已经替换好了字体,但导入后暂时不知道怎样运行起来。
 
第三个是onlyofficedocumentserver-load.tar这个包就是原生态的pull下来的镜像打的包,用save命令打的包,用loader命令导入,然后运行,需要替换字体。
 
第四个是fei3onlyoffice.tar,这个包是用5.1.5版做成的,添加了字体,修改了几处界面翻译错误,修改了。
 
第五个是fei5onlyoffice5.3.4.tar,这个包是用5.1.5版做成的,添加了字体……
 
第六个是fei6onlyoffice5.4.2.tar,这个包解决了中文字体名称问题。
 
应该下载第六个文件,放到docker命令行对应的目录下,方便运行命令导入(load)这个镜像。一般在c盘-users-administrator或者其他用户名下(在docker命令行里输入dir,看看当前目录下有哪些文件,一般就能找到这个目录了。)
 
4、启动——映射至9000端口(运行镜像后变成容器)
 
docker run -i -t -d -p 9000:80 onlyoffice/documentserver
 
如果是导入的镜像,上面的命令中onlyoffice/documentserver用镜像id代替,查阅镜像用docker images命令。
 
5、替换 添加容器onlyofficedocument server的字体
 
在网盘中下载字体winfont压缩包。字体来源于https://github.com/neroxps/Docker-Only-Office-Chinese-font和win10系统,win10系统提取中文字体的方法:控制面板——搜字体——查看安装的字体——再在搜索栏输入中文 2个字,这些就是需要的中文字体了。有些体积大的字体就不要放了,免得OO启动太慢。
 
新版自5.1.2已经以来支持中文字体了,所以不用删除它自带的字体了。但只有文泉驿的3种字体,可以根据下文再增加一些字体。
 
//进入容器(运行的镜像)内,删除/usr/share/fonts下除truetype外其他文件和文件夹
 
$ docker exec -it 38e27 /bin/bash
 
root@38e27823ae92:/#dir或者ls –al
 
root@6dfa5705aaef:~#cd /usr/share/fonts/
 
root@6dfa5705aaef:/usr/share/fonts#ls
 
truetype  X11
 
//删除文件夹X11
 
root@6dfa5705aaef:/usr/share/fonts#rm -R dir X11
 
rm:cannot remove dir: No such file or directory
 
root@6dfa5705aaef:/usr/share/fonts#ls
 
truetype
 
root@6dfa5705aaef:/usr/share/fonts#cd truetype
 
root@6dfa5705aaef:/usr/share/fonts/truetype#ls -al
 
total462392
 
drwxr-xr-x11 root   root       4096 Feb 19 04:17 .
 
………………
 
//删除trutype文件夹下所有文件,除了custome文件夹外
 
root@6dfa5705aaef:/usr/share/fonts/truetype#rm -R dir *.*
 
rm:cannot remove dir: No such file or directory
 
root@6dfa5705aaef:/usr/share/fonts/truetype#rm -R dir *
 
rm:cannot remove dir: No such file or directory
 
rm:cannot remove custom: Device or resource busy
 
root@6dfa5705aaef:/usr/share/fonts/truetype#ls
 
custom
 
root@6dfa5705aaef:/usr/share/fonts/truetype#ls -al
 
total 12
 
drwxr-xr-x10 root root 4096 Feb 19 10:14 .
 
drwxr-xr-x  6 root root 4096 Feb 19 10:12 ..
 
drwxr-xr-x  2 root root 4096 Feb 19 03:48 custom
 
……
 
root@6dfa5705aaef:/usr/share/fonts/truetype#exit
 
exit
 
Administrator@604TFALNDKDKJWCMINGW64 ~/winfont
 
//将当前文件夹C:\Users\Administrator\下的winfont文件夹内的字体全部拷贝到容器的文件夹/usr/share/fonts/truetype中
 
字体文件在我的网盘中:https://pan.baidu.com/s/1gf0ucuR
 
$ tar -cv * | docker exec -i 6df tar x -C/usr/share/fonts/truetype
 
kaiu.ttf
 
msjh.ttc
 
msjhbd.ttc
 
msjhl.ttc
 
msyh.ttc
 
msyh.ttf
 
msyhbd.ttc
 
msyhl.ttc
 
simfang.ttf
 
simhei.ttf
 
simkai.ttf
 
simli.ttf
 
simsun.ttc
 
simsunb.ttf
 
simyou.ttf
 
……
 
Administrator@604TFALNDKDKJWCMINGW64 ~/winfont
 
//进入容器内
 
$ docker exec -it 6df /bin/bash
 
root@6dfa5705aaef:/#sudo mkfontscale
 
root@6dfa5705aaef:/#sudo mkfontdir
 
root@6dfa5705aaef:/#sudo fc-cache -fv
 
/usr/share/fonts:caching, new cache contents: 0 fonts, 1 dirs
 
…………
 
fc-cache:succeeded
 
root@6dfa5705aaef:/#exit
 
exit
 
//退出容器
 
Administrator@604TFALNDKDKJWCMINGW64 ~/winfont
 
$ docker exec 6df /usr/bin/documentserver-generate-allfonts.sh
 
GeneratingAllFonts.js, please wait...Done
 
onlyoffice-documentserver:docservice:stopped
 
onlyoffice-documentserver:docservice:started
 
onlyoffice-documentserver:converter:stopped
 
onlyoffice-documentserver:converter:started
 
 如果机器重启后,断网情况下启动docker,此时不需要再运行不要用docker run命令,要用docker start 容器id,可以直接调用OO服务。
 
完成后记得清理chrome浏览器缓存,否则还是乱码新导入的字体不会生效。chrome浏览器:设置—高级—隐私设置和安全性—清除浏览数据—时间范围选择时间不限……
 
具体替换字体的命令见下图,很详细具体了。
 
修正excel、word、ppt翻译错误:
 
Administrator@604TFALNDKDKJWC MINGW64 ~/zh
 
$ docker exec -it 6df /bin/bash
 
root@6dfa5705aaef:/#cd /var/www/onlyoffice/documentserver/web-apps/apps/spreadsheeteditor/main/locale/
 
root@6dfa5705aaef:/var/www/onlyoffice/documentserver/web-apps/apps/spreadsheeteditor/main/locale#ls
 
cs.json en.json  fr.json  ja.json nl.json  pt.json  sk.json tr.json  vi.json
 
de.json es.json  it.json  lv.json pl.json  ru.json  sl.json uk.json  zh.json
 
root@6dfa5705aaef:/var/www/onlyoffice/documentserver/web-apps/apps/spreadsheeteditor/main/locale#exit
 
exit
 
Administrator@604TFALNDKDKJWC MINGW64 ~/zh
 
$ tar-cv zh.json | docker exec -i 6df tar x -C /var/www/onlyoffice/documentserver/web-apps/apps/spreadsheeteditor/main/locale/
 
zh.json
 
word的翻译文件/var/www/onlyoffice/documentserver/web-apps/apps/documenteditor/main/locale/
 
$ tar-cv zh.json | docker exec -i 6df tar x -C /var/www/onlyoffice/documentserver/web-apps/apps/documenteditor/main/locale/
 
6、还可以替换帮助文件为中文……
 
/var/www/onlyoffice/documentserver/apps/presentationeditor/main/resources/help/zh/Contents.json
 
/var/www/onlyoffice/documentserver/apps/spreadsheeteditor/main/resources/help/zh/Contents.json
 
/var/www/onlyoffice/documentserver/apps/documenteditor/main/resources/help/zh/Contents.json
 
7、连接数20个的限制
 
做完以上工作,你可以将修改后的容器保存为新的镜像,然后save导出后给其他机器用。
 
docker commit将修改后镜像保存到本地,参数是容器ID,新名字:版本标志
 
#docker ps -all
 
CONTAINER ID IMAGE   COMMAND    CREATED       STATUS          PORTS   NAMES
 
b3426410ff43 centos:7 "/bin/bash" 4 minutes ago   Exited (0) 4 seconds ago     centos7ssh
 
#docker commit b59myimage/centos7-ssh
 
下次可以输入刚保存的名字启动修改了字体的镜像了。
 
导出镜像——一定要导出保存,否则docker经常自己升级,容器啊,镜像啊,都会丢失,追悔莫及。
 
所以,启动docker的时候要关闭网络,否则它自动升级。等docker完全启动后,再打开网络。
 
docker save -o onlyoffice.tar onlyoffice/documentserver
 
6、运行和修改文档管理平台EngineerCMS
 
直接去https://github.com/3xxx/EngineerCMS查看源码
 
直接去https://github.com/3xxx/EngineerCMS/releases下载编译好的二进制文件
 
或者直接去https://pan.baidu.com/s/1gf0ucuR下载软件包,直接运行engineercms即可用浏览器chrome访问127.0.0.1了,不用配置环境,因为它是golang语言编写的跨平台的可执行文件。如果运行出现闪退,则在conf文件夹下更改app.conf文件中的端口号,或者修改runmode为prod模式。
 
(1)运行前要替换EngineerCMS\views\onlyoffice\onlyoffice.tpl中的3处IP,如果engineercms和docker安装在同一个电脑上,那么三个IP相同,见下面的6.1节。
 
(2)docker toolbox访问前要按照下文中第7节中的方法设置宿主机(安装docker的电脑)virtualbox的端口转发。win10的windows docker不用设置端口转发了。
 
有问题联系我QQ6277979,微信同号
 
人才港www.rcg.cn
 
6.1协作编辑页面要根据你的情况进行修改(ip地址、中文界面)
 
一定要用ip,不要用localhost、127.0.0.1之类的代替本机ip,本机调试要用192.168.99.100
 
注意:下文只是标识出需要修改的3处ip位置,代码并不能直接拷贝过去运行。请在engineercms文件夹中对应的原始文件上进行修改。
 
EngineerCMS\views\onlyoffice\onlyoffice.tpl:
 
 
 
   
 
 
   
    <script type="text/javascript"src="http://安装docker电脑的ip:9000/web-apps/apps/api/documents/api.js"></script>
    <scripttype="text/javascript">
        //alert({{.Doc.FileName}});
       window.docEditor = new DocsAPI.DocEditor("placeholder",
            {
               "document": {
                   "fileType": "{{.fileType}}",
                   "key": "{{.Key}}",//"Khirz6zTPdfd7"
                   "title": "{{.Doc.FileName}}",
                   "url": "http://运行engineercms电脑的ip:端口号/attachment/onlyoffice/{{.Doc.FileName}}"
                },
               "documentType": "{{.documentType}}",
               "editorConfig": {
                   "callbackUrl": "http://运行engineercms电脑的ip:端口号/url-to-callback?id={{.Doc.Id}}",
                   "user": {
                       "id": "{{.Uid}}",
                       "name": "{{.Uname}}"
                   },
                   "lang": "zh-CN",//"en-US",菜单中文化
                },
               "height": "100%",
               "width": "100%"
            });
   </script>
 
 


7、端口转发

docker pull onlyoffice/documentserver
docker run --name onlyoffice --restart always -i -t -d -p 9000:80 onlyoffice/documentserver
 
-d:后台运行 
 
-p 9000:80 :端口映射,前一个9000代表虚拟机的端口,后一个80代表docker容器的端口 
 
命令执行完成后,可以通过http://192.168.99.100:9000访问Document服务的欢迎界面,提示:Document Server is running表示正常
 
这时只能在你自己的机器上访问,同一个局域网中的其他机器是不能访问的,原因是:Windows上的docker是运行在一个虚拟机里面的,看官方给的图: 
 
 要让别的机器也访问到,需要配置一下虚拟机。设置如下: 
 
双击运行安装docker toolbox生成的Oracle VMVirtualBox。
 
点击端口转发:下图中主机IP为安装docker的电脑IP,主机端口为9000,子系统IP为192.168.99.100,子系统端口为9000。
 
这样配置完成后,别的机器也可以访问docker 容器了。
 
 
 
下文的开发仅供兴趣参考。
 
8、二次开发EngineerCMS
 
8.1 协作编辑页面
 
 
 
 
   
 
 
   
    <script type="text/javascript"src="http://安装docker电脑的ip:9000/web-apps/apps/api/documents/api.js"></script>
    <scripttype="text/javascript">
        //alert({{.Doc.FileName}});
        window.docEditor = newDocsAPI.DocEditor("placeholder",
            {
               "document": {
                   "fileType": "{{.fileType}}",
                   "key": "{{.Key}}",//"Khirz6zTPdfd7"
                   "title": "{{.Doc.FileName}}",
                   "url": "http://运行engineercms电脑的ip:端口号/attachment/onlyoffice/{{.Doc.FileName}}"
                },
                "documentType":"{{.documentType}}",
               "editorConfig": {
                   "callbackUrl": "http:// 运行engineercms电脑的ip:端口号/url-to-callback?id={{.Doc.Id}}",
 
                   "user": {
                       "id": "{{.Uid}}",
                       "name": "{{.Uname}}"
                   },
                   "lang": "zh-CN",//"en-US",
                },
               "height": "100%",
               "width": "100%"
            });
   </script>
 

 

8.2 协作页面的保存和回调——下面是go语言,官方文档有phpjavanode.js等。

 
type Callback struct {
   Key         string   `json:"key"`
   Status      int     `json:"status"`
   Url         string   `json:"url"`
   Changesurl  string  `json:"changesurl"`
   History     history `json:"history"`
   Users       []string `json:"users"`
   Actions     []action `json:"actions"`
   Lastsave    string  `json:"lastsave"`
   Notmodifiedbool     `json:"notmodified"`
}
type action struct {
   Type   int
   userid string
}
type history struct {
 changes       []change
   serverVersionstring
}
type change struct {
   created string
   User    User1
}
 
type User1 struct {
   id   string
   name string
}
 
//关闭浏览器标签后获取最新文档保存到文件夹
func (c *OnlyController) UrltoCallback() {
   // pk1 :=c.Ctx.Input.RequestBody
   id :=c.Input().Get("id")
   //pid转成64为
   idNum, err :=strconv.ParseInt(id, 10, 64)
   if err != nil {
      beego.Error(err)
   }
   //根据附件id取得附件的prodid,路径
   onlyattachment,err := models.GetOnlyAttachbyId(idNum)
   if err != nil {
      beego.Error(err)
   }
 
   var callbackCallback
   json.Unmarshal(c.Ctx.Input.RequestBody,&callback)
   ifcallback.Status == 1 || callback.Status == 4 {
      c.Data["json"]= map[string]interface{}{"error": 0}
      c.ServeJSON()
   } else ifcallback.Status == 2 {
      resp, err :=http.Get(callback.Url)
      if err != nil{
         beego.Error(err)
      }
      body, err :=ioutil.ReadAll(resp.Body)
     if err != nil{
         beego.Error(err)
     }
      deferresp.Body.Close()
      if err != nil{
         beego.Error(err)
      }
      f, err :=os.create(".\\attachment\\onlyoffice\\"+onlyattachment.FileName)
      if err != nil{
         beego.Error(err)
      }
      deferf.Close()
      _, err =f.Write(body)
      if err != nil{
         beego.Error(err)
      } else {
         err =models.UpdateOnlyAttachment(idNum)
         if err !=nil {
            beego.Error(err)
         }
      }
      c.Data["json"]= map[string]interface{}{"error": 0}
      c.ServeJSON()
   }
}
 


engineercms的文档管理: 
 
大神解读在Windows或Liunx系统上使用ONLYOFFICE协作编辑文档开发

word文件协作效果:

大神解读在Windows或Liunx系统上使用ONLYOFFICE协作编辑文档开发



PowerPoint文档演示:

大神解读在Windows或Liunx系统上使用ONLYOFFICE协作编辑文档开发


Excel表格在线编辑演示:

大神解读在Windows或Liunx系统上使用ONLYOFFICE协作编辑文档开发

分享到:

相关文章
关于深网

“赣州深网www.gzsw.net.cn”是赣州深网科技有限公司所拥有的互联网服务品牌。公司主要致力于向广大用户提供优质的互联网基础服务。公司拥有一支由资深技术专家、优秀的管理、服务人才组成的运营团队,有着多年的互联网运营服务从业经验。公司先后与国内多家知名互联服务企业合作,取得了瞩目的成绩,资源、技术优势得到进一步提升。深网为企业、政府、组织提供网站开发设计、域名注册、网站主机、网站SEO优化、微站、公众号平台、小程序开发等。 联系电话:137-6633-3304

案例分享
立即咨询