Git Product home page Git Product logo

learnopengl-cn's Introduction

LearnOpenGL中文化工程

Build Status

learnopengl.com系列教程的中文翻译,目前正在校对及翻译中。

英文原版learnopengl.com

目前状态

  • 原文大部分代码都有改变(使用的新的库),需要从头开始重新校对(Krasjet正在处理中,最重要的配置部分已经更新完毕)
  • 5-2节之后都没有按照新版的格式来排版,而且错误极多,也没有统一译名,需要进行整体的修改(Krasjet正在处理中,可能比较漫长)
  • 从头校对整体修改之后的文章(志愿者希望)
  • PBL 章节和 In Practice 章节下还有几篇教程没有翻译(志愿者希望)

阅读地址

目前Host在GitHub上,可以点击这里进行阅读。

旧版本的Host在Read The Docs内(不定时更新),可以点击这里进行阅读。

认领翻译

由于我们的志愿者来自五湖四海,为了避免冲突。请志愿者们先Clone这个Repository 。同步到本地后找到要翻译的文章,创建一个如下所示的只包含作者、翻译者和原文链接信息的Markdown文件:

原文     | [英文标题](原文地址)
      ---|---
作者     | JoeyDeVries
翻译     | [翻译]
校对     | 暂无

译文的文件命名统一规范为:

<两位数的章序列> <章名称>/<两位数节序列> 节名称.md

如果有小节的话:

<两位数的章序列> <章名称>/<两位数节序列> 节名称/<两位数小节序列> 小节名称.md

例如:

01 Getting started/01 OpenGL.md
或
05 Advanced Lighting/03 Shadows/02 Point Shadows.md

翻译之前请先阅读样式指南

之后请联系我们,将您加入LearnOpenGL-CN组织,然后提交并Push您的翻译。或者您也可以Fork这个工程在本地编辑之后发送Pull Request。

样式指南

在文档的写作过程中,请遵守我们的样式指南方便之后的校对以及修改工作。

构建

首先请安装Python,2和3都可以,之后初始化环境:

$ pip install mkdocs
$ python setup.py install

初始化以后,每次构建只需要输入以下指令即可,构建后的文件在site文件夹内:

$ mkdocs build

如果只是想测试的话,请输入以下指令:

$ mkdocs serve

部署的网页可以通过127.0.0.1:8000来访问。

建议

如果您发现教程有任何错误的话,欢迎Fork这个工程并发送Pull Request到 new-theme 分支。如果您不想修改的话,可以点击页面上方的 Issues 按钮提交一个Issue,我们看到后会及时更正。如果是对教程的内容有问题,请先查看原文,如果不是翻译错误的话,请直接在原网站评论区向作者(JoeyDeVries)反馈。

联系方式

QQ群:383745868

learnopengl-cn's People

Contributors

krasjet avatar geequlim avatar meow-j avatar aillieo avatar gjy1992 avatar blumia avatar keyantu avatar jchaos avatar hellokenlee avatar jiangmuwen avatar shirokosama avatar cadenji avatar fuzhenn avatar hizhaoxiaoyang avatar yaqinking avatar linkoln avatar ljxljxljx avatar cocoonshu avatar andybigfish avatar timrockefeller avatar acprime avatar liubgithub avatar giserman avatar usunyu avatar cedarz avatar huanghaozi avatar rickygao avatar sanerror avatar unnamed2 avatar qingfenglee avatar

Watchers

James Cloos 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.