GithubHelp home page GithubHelp logo

Comments (9)

Justineo avatar Justineo commented on April 27, 2024 2

目前 Vue 3 的配置在这里:https://github.com/algolia/docsearch-configs/blob/master/configs/vuejs-v3.json

from docs-next-zh-cn.

Justineo avatar Justineo commented on April 27, 2024 1

Algolia Docsearch 我记得直接支持配置多语言的,需要给他们的配置仓库提交一个 PR。

from docs-next-zh-cn.

QC-L avatar QC-L commented on April 27, 2024 1

把英文文档的配置,改个名字就可以了。具体配置会有人帮忙修改的

from docs-next-zh-cn.

Jinjiang avatar Jinjiang commented on April 27, 2024 1

我为我们的文档提交了独立的申请,有几点考虑:

  • DocSearch 的多语言配置感觉更像是在同一个站点下的,感觉和我们目前的状态不太吻合。
  • 我们 v2 的文档中英文也是分看的 https://github.com/algolia/docsearch-configs/blob/master/configs/vuejs_cn2.json
  • 中心化的多语言配置不只是中文版的问题,需要和整个文档团队商量,从目前 Vue 团队的文档和翻译工作现状来看,个人觉得比较难协作
  • 从体验上看,分开申请不存在实际的体验问题

更多进展我会及时同步到这里。

from docs-next-zh-cn.

veaba avatar veaba commented on April 27, 2024

更新algolia特性(待定):似乎需要提交docs 地址,algolia 会帮忙抓取数据,在等邮件通知结果。

from docs-next-zh-cn.

Jinjiang avatar Jinjiang commented on April 27, 2024

@yyx990803 我们可以像 v2 中文站一样申请 Algolia 站内搜索吗?是否存在某些前置条件 (比如需要域名先生效)?

from docs-next-zh-cn.

QC-L avatar QC-L commented on April 27, 2024

@Jinjiang 可以申请的,申请方式很简单。

from docs-next-zh-cn.

veaba avatar veaba commented on April 27, 2024

结合@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 搜索 结果:

image


方式一的提前是,证书问题需要解决。

目前v3 中文站有两种方式可以访问(后续需要测试访问速度来决定采取何种部署方案):

  1. 通过 netlify 部署的:https://vue-docs-next-zh-cn.netlify.app (国内访问比较卡,测试地:杭州)
  2. 通过 github actions 部署的 gh-pages::https://v3.cn.vuejs.org (证书原因无法访问)

之前筹备的域名 v3.cn.vuejs.org 现在似乎是因为 Cloudflare 证书的原因,无法访问 gh-pages 分支,提示如下:

ERR_SSL_VERSION_OR_CIPHER_MISMATCH

image

总结:中文仓库支持 algolia 特性也是可以的,速度还算不错,方法也找到了,只是需要解决域名证书的问题。

from docs-next-zh-cn.

veaba avatar veaba commented on April 27, 2024

我为我们的文档提交了独立的申请,有几点考虑:

  • 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)

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    🖖 Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo 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.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google ❤️ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.