https://docs.travis-ci.com/user/deployment/pages/

from examples.

OR, with circleci deployment.sh, like below

• mkdir build
• checkout this repo to build/examples
• checkout docs to build/docs
• run gulp build under build/examples
• run git -C build/docs commit -a -m "update examples"
• run git -C build/docs push --force, after setup token(how to?)

circle ci 1.0

https://circleci.com/docs/1.0/configuration/#deployment

circle ci 2.0

https://circleci.com/docs/2.0/deployment_integrations/

from examples.

我认为, travis ci的deploy还是简单些.

对于这个repo, 可以改名为maptalks/examples, 然后发布到它的gh-pages分支, 形成https://maptalks.github.io/examples/en/index.html这样的url;

对于api文档, 可以发布到maptalks/maptalks.js的gh-pages分支, 也可以新建一个repo, 如maptalks/api;

from examples.

CircleCI的deploy也不算是很复杂, 这里有个参考.

• 需要设置ssh key(machine user key/github user key), 或者OAuth Token. 自行评估三种方式的安全性.
• circle.yml里的deployment配置
• deployment脚本
• CircleCI的WebUI中的git相关环境变量(如果写在deployment脚本中, 就不需要)

对于发布的目标位置(gh-pages的话), 我觉得仓库自身的gh-pages分支比较好.
@fuzhenn @brucin

from examples.

circleCI目前比较强势, 到处在打广告, 我们还是用circleCI

我也同意按你说的, 把页面发布在仓库自身的gh-pages中.

那就按照你的想法先把examples做一下吧

• 用circleCI
• CI中设置maptalks-doc-robot的ssh key
• 编写脚本, 每次更新时, 自动生成页面并commit到gh-pages分支中

from examples.

API文档的生成有两个选择:

• 按你说的提交到maptalks.js的gh-pages分支中
• 每次npm publish时, 在maptalks.js的master/doc目录下生成文档(github支持在master/doc下发布网站)

我感觉第二个选择也不错

from examples.