Comments (9)
目前 Vue 3 的配置在这里:https://github.com/algolia/docsearch-configs/blob/master/configs/vuejs-v3.json
from docs-next-zh-cn.
Algolia Docsearch 我记得直接支持配置多语言的,需要给他们的配置仓库提交一个 PR。
from docs-next-zh-cn.
把英文文档的配置,改个名字就可以了。具体配置会有人帮忙修改的
from docs-next-zh-cn.
我为我们的文档提交了独立的申请,有几点考虑:
- DocSearch 的多语言配置感觉更像是在同一个站点下的,感觉和我们目前的状态不太吻合。
- 我们 v2 的文档中英文也是分看的 https://github.com/algolia/docsearch-configs/blob/master/configs/vuejs_cn2.json
- 中心化的多语言配置不只是中文版的问题,需要和整个文档团队商量,从目前 Vue 团队的文档和翻译工作现状来看,个人觉得比较难协作
- 从体验上看,分开申请不存在实际的体验问题
更多进展我会及时同步到这里。
from docs-next-zh-cn.
更新algolia特性(待定):似乎需要提交docs 地址,algolia 会帮忙抓取数据,在等邮件通知结果。
from docs-next-zh-cn.
@yyx990803 我们可以像 v2 中文站一样申请 Algolia 站内搜索吗?是否存在某些前置条件 (比如需要域名先生效)?
from docs-next-zh-cn.
@Jinjiang 可以申请的,申请方式很简单。
from docs-next-zh-cn.
结合@Justineo 上面 反馈的情况 与我自己的测试结果实现 algolia 特性 方案如下:
-
方式一:需要给Algolia 发起 PR ,添加 v3 中文站的搜索配置文件,请求他们帮忙收录站点。
-
方式二:如果自己制作的话就很麻烦,需要一定的数据结构才能呈现(不建议采取这种方式。官方给定的默认demo数据结构,就是那个firstName的不行。):
比如需要导入类似这个 json结构:
{
"type": "lvl1",
"url": "https://v3.vuejs.org/api/options-dom.html#dom",
"content": "Now when you run vm.fullName = 'John Doe' , the setter will be invoked and vm.firstName and vm.lastName will be updated accordingly",
"hierarchy": {
"lvl0": "Essentials",
"lvl1": "Computed Properties and Watchers",
"lvl2": "Computed Properties",
"lvl3": "Computed Setter"
},
"objectID": "5671297001"
}
Algolia 搜索 结果:
方式一的提前是,证书问题需要解决。
目前v3 中文站有两种方式可以访问(后续需要测试访问速度来决定采取何种部署方案):
- 通过 netlify 部署的:https://vue-docs-next-zh-cn.netlify.app (国内访问比较卡,测试地:杭州)
- 通过
github actions
部署的gh-pages
::https://v3.cn.vuejs.org (证书原因无法访问)
之前筹备的域名 v3.cn.vuejs.org
现在似乎是因为 Cloudflare 证书的原因,无法访问 gh-pages
分支,提示如下:
ERR_SSL_VERSION_OR_CIPHER_MISMATCH
总结:中文仓库支持 algolia
特性也是可以的,速度还算不错,方法也找到了,只是需要解决域名证书的问题。
from docs-next-zh-cn.
我为我们的文档提交了独立的申请,有几点考虑:
- DocSearch 的多语言配置感觉更像是在同一个站点下的,感觉和我们目前的状态不太吻合。
- 我们 v2 的文档中英文也是分看的 https://github.com/algolia/docsearch-configs/blob/master/configs/vuejs_cn2.json
- 中心化的多语言配置不只是中文版的问题,需要和整个文档团队商量,从目前 Vue 团队的文档和翻译工作现状来看,个人觉得比较难协作
- 从体验上看,分开申请不存在实际的体验问题
更多进展我会及时同步到这里。
参考前面讨论的(https://github.com/vuejs/docs-next-zh-cn/issues/7#issuecomment-688620296) ,应该可以仿照英文版 v3 的config ,可能需要一个conversation_id,为此我昨天也申请了,等批下来,看下结果。
from docs-next-zh-cn.
Related Issues (20)
- 翻译表述有误 HOT 5
- bug: 组件自闭合会导致后面的内容无法显示 HOT 1
- 开启生产环境模式 HOT 8
- vue3.2.12版本defineExpose返回的数组会被深度reactive化(数组内部的对象会变成proxy) HOT 1
- bug:
- Caveats 如何翻译的问题 HOT 7
- Vue支不支持在浏览器中直接运行vue单文件呢 HOT 1
- When I use Jump to the main content link function + vue - while on a router cannot jump to the main content HOT 1
- bug: 在vue3的组件中,父组件给子组件传入一个router-link的to的路径 ,子组件读取不到 HOT 1
- bug: [文档]渲染函数-创建组件-vnode可能错误 HOT 1
- bug: 修改响应式 property 的代码示例错误使用this HOT 4
- sleight-of-hand 是否翻译为 “微调” 比较合适呢? HOT 2
- 关于transition动画里的文档错误 HOT 2
- bug: 中文文档中自定义指令描述错误! HOT 4
- array-refs中的文案错误 HOT 1
- 有没有完整示例代码? HOT 1
- bug: vue3.2.29通过v-for显示component组件通过ref调用子组件方法时提示子组件方法为undefined
- bug: vue3.2.29通过v-for显示component组件通过ref调用子组件方法时提示子组件方法为undefined HOT 1
- 对于远端动态组建的api有支持吗
- 该版本文档停止更新,欢迎去新版文档贡献 HOT 1
Recommend Projects
-
React
A declarative, efficient, and flexible JavaScript library for building user interfaces.
-
Vue.js
🖖 Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.
-
Typescript
TypeScript is a superset of JavaScript that compiles to clean JavaScript output.
-
TensorFlow
An Open Source Machine Learning Framework for Everyone
-
Django
The Web framework for perfectionists with deadlines.
-
Laravel
A PHP framework for web artisans
-
D3
Bring data to life with SVG, Canvas and HTML. 📊📈🎉
-
Recommend Topics
-
javascript
JavaScript (JS) is a lightweight interpreted programming language with first-class functions.
-
web
Some thing interesting about web. New door for the world.
-
server
A server is a program made to process requests and deliver data to clients.
-
Machine learning
Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.
-
Visualization
Some thing interesting about visualization, use data art
-
Game
Some thing interesting about game, make everyone happy.
Recommend Org
-
Facebook
We are working to build community through open source technology. NB: members must have two-factor auth.
-
Microsoft
Open source projects and samples from Microsoft.
-
Google
Google ❤️ Open Source for everyone.
-
Alibaba
Alibaba Open Source for everyone
-
D3
Data-Driven Documents codes.
-
Tencent
China tencent open source team.
from docs-next-zh-cn.