下载的pdf中字体是在是太好看了，到底是什么字体呀

zh-google-styleguide的工作人员你们好：
你们有这样的插件吗？
当你的编码不符合谷歌要求的编码风格，他会让编译器弹出警告，并要求你修改。

如图：

这个是阿里巴巴的Java 规约插件https://github.com/alibaba/p3c

有没有谷歌C++代码规约的插件呢？帮助我养成良好C++编码风格。

感谢！

比如-inc.h谷歌已经禁止使用了

Not Found

The requested URL /svn/trunk/google-c-style.el was not found on this server.

http://zh-google-styleguide.readthedocs.org/en/latest/google-cpp-styleguide/formatting/

• 另外, 我们写了一个 emacs 配置文件 来帮助你正确的格式化代码.

2. 作用域
   2.1. 命名空间
   结论
   命名空间命名
   的链接已经失效，麻烦重新链接，谢谢~

感觉需要区分下什么是文件头，头文件，文件声明，文件头一般指的是format文件二进制开始的特征码

建议不应该翻译为导入黑客
建议:导入黑科技,或者直接只放原文.

在 2.4 局部变量中, 个人觉得可以在增加译注: 关于Warning
开销: (循环内构造 + 析构) > (块外定义 + 赋值)
我觉得一言蔽之是不合理的, 我们应该合理分析一下成本:

构造 + 析构: n * (construct + destruct)
块外定义 + 赋值: n * assignment

哪个开销更高, 我们应该具体衡量, <Google C++ Style Guide>翻译的挺不错的
但是 , 能够加上我们译者的具体建议, 不是更好吗 ?

相关内容: 可见<Effective C++> Item 26

https://google.github.io/styleguide/cppguide.html#Inputs_and_Outputs

原文：
Input parameters should usually be values or const references, while non-optional output and input/output parameters should usually be references (which cannot be null).

8.3中指出缩进为2个空格，但是8.4中示例代码中缩进为4个空格

项目链接是zh-google-styleguide.readthedocs.org/，但是这个文档比较旧了，README中的链接为google-styleguide.readthedocs.org/，这个是最新的文档，有Javascript风格指南。建议将项目链接修改为google-styleguide.readthedocs.org/

reStructuredText格式转换为markdown格式过程中的问题及解决方法

Q: 为什么要把reStructuredText格式转换为markdown格式？

1. 在当前版本中大量存在中英文标点混用的情况（逼死强迫症:D），既然本项目致力于将英文版翻译为中文版，强烈建议使用统一的中文标点，而使用统一的中文标点会造成Sphinx解析格式错误，参见#30 。对于markdown格式目前没有这类解析格式错误。
2. markdown格式相对reStructuredText格式使用的人更多，入门门槛较低，也便于中文版本格式维护。

Q: 你计划转换本仓库的哪些部分？

基于个人兴趣和时间因素考虑，我仅计划转换《Google C++风格指南》这一部分，其他部分暂无计划，希望有同样兴趣的GitHuber能接力完成剩下部分的格式转换。

Q: 你将如何实现reStructuredText格式到markdown格式的转换？

基于对各种自动化、半自动化转换工具的不信任，我将采用纯手工这一最原始的方式进行转换，如果你有任何理想的转换工具推荐，请@我进行推荐。

Q: 转换工作包括哪几步？

1. 在不改变文本内容的前提下，将rst格式转换为md格式。
2. 统一文件中的标点为中文标点。
3. 修正个别翻译不通顺的语句。

Q: 提这个Issue的原因是什么？

在转换的过程中必然会遇到一些问题，也会针对这些问题寻求大家的帮助，以便找到解决问题的方法。我计划把转换过程中遇到的问题都记录在此Issue中，在转换工作完成后，如果时间允许，计划将此Issue中的问题与解决方法进行整理，方便以后有其他人计划将reStructuredText格式转换为markdown格式时能从此Issue中获得灵感。

Q: 怎么查看正在进行中的转换工作？

所有的转换工作都在ilcc/zh-google-styleguide仓库的feature-markdown分支中进行。

Q: 怎么联系你？

如果你对转换工作有任何的建议和意见，请在此Issue中留言，并@ilcc方便我及时了解你的想法和建议。

大部分文本编辑器 (包括 OS X) 为了优化汉字显示, 实际上汉字占宽是英文的 1.5 倍, 但是实际上 sphinx, reStructuredText 和 Terminal 等, 都内部将汉字解析成 2 倍英文字符宽度.

所以文本编辑器显示的时候是 header 和下划线是左右对齐的, 但是实际上内部解析是不对齐的.

我通常的解决方法是下划线对齐后, 再增长至 2 倍或 1.5 倍.

7. 注释
------
/home/docs/checkouts/readthedocs.org/user_builds/zh-google-styleguide/checkouts/latest/google-cpp-styleguide/comments.rst:9: WARNING: Title underline too short.

这时隐式转换会作用域右侧的参数却不会作用于左侧，“域”应为“于”

在 5. 来自 Google 的奇技 一文的 译者注 中，译者认为 scoped_ptr 已经过时。但是实际上 scoped_ptr 现在依然是一种行之有效且非常好用的手法，只是不知道为什么标准库没提供而已。

尽管 shared_ptr 看起来是未来，但是事实上 shared_ptr 有很多坑 ¹ ，而且在多线程中表现不佳，所以我认为译者注的第三条应当去掉

[注1] C++ shared_ptr四宗罪(不得不转)

如题

你好，java style有在进行吗？

下载了所有的code,但是编译出错. 能否把编译好的PDF放到网站上.谢谢

zh-google-styleguide$ make latexpdf
sphinx-build -b latex -d _build/doctrees . _build/latex
Running Sphinx v1.6.3

Exception occurred:
File "conf.py", line 23, in
import sphinx_rtd_theme
ModuleNotFoundError: No module named 'sphinx_rtd_theme'
The full traceback has been saved in /tmp/sphinx-err-aufw9_0q.log, if you want to report the issue to the developers.
Please also report this if it was a user error, so that a better error message can be provided next time.
A bug report can be filed in the tracker at https://github.com/sphinx-doc/sphinx/issues. Thanks!
Makefile:101: recipe for target 'latexpdf' failed
make: *** [latexpdf] Error 1
zh-google-styleguide$ which python

中文版项目采用 reStructuredText 纯文本标记语法, 并使用 Sphinx 生成 HTML / CHM / PDF 等文档格式.

我没有找到啊，请问PDF文档在哪啊
另：谢谢翻译，看英文好吃力

missing content of the pdf file
http://zh-google-styleguide.readthedocs.io/en/latest/contents/

New Rules for auto deduction from braced-init-list

#include <cstdio>
#include <typeinfo>
#include <initializer_list>

int main() {
    auto var{100};
    //  auto var_list{100, 200}; //  compile error
    std::initializer_list<int> lst{100};
    printf("%s\n", typeid(decltype(var)).name());
    printf("%s\n", typeid(decltype(lst)).name());
}

----------- OUTPUT -------------
C:\Users\jcong\CLionProjects\untitled\cmake-build-debug\untitled.exe
i
St16initializer_listIiE

Process finished with exit code 0

在Sphinx v2.0.0上make会报如下问题：

Running Sphinx v2.0.0
loading translations [en_US]... not available for built-in messages

Extension error:
Could not import extension sphinx.ext.pngmath (exception: No module named 'sphinx.ext.pngmath')

屏蔽conf.py文件的15行

extensions = ['sphinx.ext.pngmath']

可以解决以上问题.所以建议更新下最新的conf.py文件

line 363
https://github.com/zh-google-styleguide/zh-google-styleguide/edit/master/google-python-styleguide/python_style_rules.rst

if i & (i-1) == 0: # true iff i is a power of 2

if ?

对于filler characters，是英文拼错，还是中文就是这个意思，或者中文翻译不对？

原文中是：Use quotes rather than filler characters where possible.

译文中是：尽可能使用引用，而不是过滤字符串。

Python风格指南---->语言规范---->属性（Property）

def ___set_area(self, area):
             """Indirect setter for 'area' property."""
             self._SetArea(area)

应该是

def ___set_area(self, area):
             """Indirect setter for 'area' property."""
             self.__set_area(area)

在这里可以找到原文：https://google.github.io/styleguide/pyguide.html#Properties

到底是使用英文半角还是中文全角标点符号，请规范一下，谢谢！

如题，请查看http://google.github.io/styleguide/cppguide.html#Self_contained_Headers这里的源代码和ReadTheDocs中的对应文本。

1.3 前置声明：缺点
用例代码：
struct D : B {}
一行，缺少分号，可能并不会带来什么问题，但我可能是个强迫症吧。

zh-google-styleguide/google-cpp-styleguide/headers.rst
头文件的include顺序，官方改成了几乎完全相反的了https://google.github.io/styleguide/cppguide.html#Names_and_Order_of_Includes

和传统的词汇保持一致比较好．

刚提交的某 pull request 被 merged 后，发现我的 contributions graph 居然没计入这些 commits! Commit was made in a fork 提到：

• To detach the fork and turn it into a standalone repository on GitHub, contact GitHub support.

所以我现在去联系 GitHub support 了，摇身一变成正式的独立项目吧！

This long time before this repo was updated. Is there any problem of translating? Or is this project no longer needed because others may have create a better one?

Please let me know the latest news of this project. Thank you.

8.8. 标点, 拼写和语法
8.8. TODO 注释

前一个应该是8.7

1. 章节和来自Google的奇技同为第5章，是否应该改为第6章？
2. other.rst有数节已经移到其他章，为何还保留并且是旧的翻译？
   参考https://google.github.io/styleguide/cppguide.html
   应该删去
   5.1 引用参数
   5.3 函数重载
   5.4 缺省参数
   5.5 变长数组和alloca()

本来想对官方提交 pull request 的，但误操作成在 fork 项目里的 pull request 了。

我全更新好会再正式推送 pull request 过来。

以免撞坑，特此公告！

在编译的时候碰到的问题是
exception: No module named 'sphinx.ext.pngmath'

Fix typo in README.rst

File: README.rst
Line: 36
Original: 另外, 招募自愿者翻译 ...
Fixed: 另外, 招募志愿者翻译 ...

章节标号错误。

我想下载格式里面提供的那个emacs配置文件，可是当打开链接的时候为什么提示找不到网页。。。。

原文说的是：
Support 'perfect forwarding' in generic code.
You may use forwarding references in conjunction with std::forward, to support perfect forwarding.

http://zh-google-styleguide.readthedocs.io/en/latest/google-cpp-styleguide/others/

网页上是这样的
5. 来自 Google 的奇技
5. 其他 C++ 特性
7. 命名约定

如图，标记处的应该是 括号 -> 空格

用空格把大括号与实现分开.

最近Google C++英文版风格指南更新了很多内容，包括作用域和类。其中关于接口那一部分的内容不见了，不知道是不是被删除了，现在英文版对“接口”没有明确的命名（Interface）和规范等要求，不知道是否需要更新，可以的话我想提交PR

麻烦 @yangyubo 重新编译下网站吧。

下面这个才是对的，这个文档也太旧了吧

@implementation Foo {
  NSString *_bar;
  NSString *_foo;
}

呼吁加上go语言，谢谢，可以参考
https://github.com/bahlo/go-styleguide 翻译

以及 https://segmentfault.com/a/1190000000464394

Good resource

应该是因为当前 js 目录中没有 index.rst 文件，感觉可以像 ts 的做法，在链接后面加入 /contents 的 path

感谢各位的精彩翻译，辛苦 :-)