Giter VIP home page Giter VIP logo

leaflet_zh's Introduction

Leaflet - 中文文档

Leaflet 是一个开源并且对移动端友好的交互式地图 JavaScript 库。本项目目的在于为国内使用 Leaflet 的小伙伴们提供一份内容完善、准确度相对较高并且更新及时的中文文档,希望能够给大家在学习或开发过程中带来一定的便利。

Leaflet 中文站点:https://leafletjs.cn/

Leaflet 官方站点:https://leafletjs.com/

Robeeask 社区:https://leafletjs.robeeask.com/

翻译进度(v1.7.1)

已完成全部板块的文档翻译和初步校正工作,目前正在进行第二轮的文档校正。

  • 概况(已校正)
  • 教程
    • 列表页(已校正)
    • Leaflet 快速入门指南(已校正)
    • Leaflet 在手机上使用(已校正)
    • Markers 自定义图标(已校正)
    • 在 Leaflet 中使用 GeoJSON(已校正)
    • 互动式choropleth地图(已校正)
    • Layer Groups 和 Layers Control(已校正)
    • Zoom levels 缩放比例(已校正)
    • Non-geographical maps(已校正)
    • WMS and TMS(已校正)
    • Working with map panes(已校正)
    • 显示视频文件(已校正)
    • 扩展 Leaflet: Class Theory(已校正)
    • 扩展 Leaflet: Layers(已校正)
    • 扩展 Leaflet: Handlers and Controls (已校正)
  • 文档
    • 地图(已校正)
    • 地图方法(校正中)
    • UI 图层
    • 栅格图层(已完成,by DanPlayer)
    • 地图杂项
    • 矢量图层(已完成,by zhsdcode)
    • 其它图层(已完成,by zhsdcode)
    • 基本类型(已完成,by zhsdcode)
    • 控件(已完成,by zhsdcode)
    • Util常用方法类(已完成,by zhsdcode)
    • Dom常用方法类(已完成,by zhsdcode)
    • 基础类(已完成,by zhsdcode)
    • 其它(已完成,by zhsdcode)
  • 下载
  • 插件(对新增的文档进行翻译中)
    • Tile & Image 图层(已完成,by lazytuanzi)
    • 叠加数据(已完成,by lazytuanzi)
    • 叠加显示
    • 叠加交互
    • 地图交互
    • 各种各样的
    • 综合的
    • 开发属于自己的插件
  • 博客(已完成,by zhsdcode)

加入翻译

由于本人精力有限,希望更多的小伙伴可以加入我们,一起参与翻译,共同来帮助更多人。如果你完全没接触过翻译工作也不用担心,我们将会为你准备完善的翻译规范和操作说明。

开始翻译前,你可以先加入我们的交流群,然后在群里通过以下方式认领,确保没有重复工作。

认领制度

对于未被翻译的章节,你应该在翻译之前进行翻译认领来保证没有人和你重复工作。 很简单,请从 repo 的 issue 列表中认领,如果没有对应章节的 issue,自己创建一个即可。 认领成功后就代表你已经成功占到一个坑,你可以开始慢慢翻译自己的文章了。 如果占坑太久你的占位可能被取消,尽量在两周内完成。

对于已经翻译的章节,欢迎做校验工作,校验不需要认领,fork 后修改并发 Pull Request 即可。

翻译流程

1、fork 要翻译的 repo

2、如果是新翻译章节,应参照对应的原文进行翻译;如果是校对则直接修改

建议使用 Sublime Text、Vscode 等支持 Markdown 类编辑器编辑,同时开启横向双列模式。

3、安装 jekyll, 翻译时启动 watch 来实时看结果(jekyll官方安装文档

jekyll serve

打开:127.0.0.1:4000

4、翻译结束,提交 Pull Request

5、fork 后的 repo 如何同步本 repo?

// 添加 upstream 源,只需执行一次
git remote add upstream https://github.com/NICEXAI/leaflet_zh.git
// 拉取远程代码
git pull upstream master
// 更新 fork 仓库
git push origin master

更多参考:https://help.github.com/articles/syncing-a-fork/

其它事项

C:\User>gem install jekyll
Temporarily enhancing PATH for MSYS/MINGW...
Building native extensions. This could take a while...
ERROR:  Error installing jekyll:
    ERROR: Failed to build gem native extension.

    current directory: C:/Ruby25-x64/lib/ruby/gems/2.5.0/gems/http_parser.rb-0.6.0/ext/ruby_http_parser
C:/Ruby25-x64/bin/ruby.exe -r ./siteconf20180308-3672-ueo7ea.rb extconf.rb
creating Makefile

current directory: C:/Ruby25-x64/lib/ruby/gems/2.5.0/gems/http_parser.rb-0.6.0/ext/ruby_http_parser
 make "DESTDIR=" clean

如果安装 jekyll 过程中遇到上面问题或者安装 msys2 过程中报错,可以参考以下文章进行解决:

参与翻译人员名单

定期更新,谢谢各位辛勤贡献

特殊贡献者人员名单

  • 寒江孤影
  • 三月

其它方面的支持与赞助

  • 特别感谢 Robeeask 社区 对 Leaflet 中文网的部分资金赞助
  • 特别感谢 JetBrains 为本开源项目提供免费的 License 授权

只要文档符合 翻译规范,欢迎你来一起完善

leaflet_zh's People

Contributors

nicexai avatar zhsdcode avatar danplayer avatar gwynethou avatar lazytuanzi avatar

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.