gae-boilerplate documentation

Question

在我为App Engine寻找一个良好的社交登录包的过程中，我给了gae-boilerplate一个尝试。但是我发现除了自述文件之外没有任何文档，我认为它是不够的。

我有很多问题，其中包括：

• 应该样板被用来作为一个库或下载并根据需要进行修改？
• 样板应该如何更新？
• 每个模型都做了什么？
• 我的模板应该放在哪里？
• 我应该有不同的路线文件吗？
• 我应该从BaseHandler派生我的处理程序吗？
• 一般来说，我应该在我的页面中执行什么操作？例如，我发现我必须在所有POST请求中包含一个csrf_token。我很高兴知道这件事，还有很多其他的事情，我不得不一路发现，而且我不确定自己是否应该这样做。
• 还有一些更多...

我最大的问题是，社会登录不工作，我觉得这个样板是一个大怪物，我不知道从哪里开始。更糟糕的是，很难从任何不是生产机器的社交认证中进行调试。这就是为什么我拼命寻找一些文档。

我还没有发现任何东西，我想在我的情况下必须有更多的人。因此，任何能够帮助理解gae-boilerplate更好一点的文档指针都将非常值得赞赏。

编辑：我切换到gae-boilerplate在我以前工作的网站。也许我的大部分问题都来自于我试图整合gae-boilerplate和我现有网站的方式。因此，我试图将gae-boilerplate作为库来处理，并保留自己的模板，处理程序，静态文件等。

谢谢你们！

编辑2：尝试其他选项后，我不得不说我对gae-simpleauth很满意。它工作得很好，Alex的支持非常好。

Answer 1

我会尽量回答你的大部分问题如下：

• 应该样板被用来作为一个库或下载并根据需要修改？
  • 根据您的具体要求，您可以根据需要对其进行修改。
• 应如何更新样板文件？
  • 你是什么意思？
• 每个模型都做什么？
  • User和SocialUser很自我解释。 LogVisit和LogEmail用于审计目的。
• 我的模板应该去哪里？
  • 在模板目录
• 我应该有一个不同的路线文件？
  • 不，您可以使用现有的文件为您的所有路线。
• 我应该从BaseHandler派生我的处理程序吗？
  • 这不是强制性的，但我会建议这样做。 BaseHandler非常方便，并提供了很多好东西。
• 一般来说，我应该在我的页面中执行什么操作？
  • 你究竟是什么意思？

在一般情况下，你可以使用GAE，作为样板在上面参考其中的你会建自己的项目。逐步研究代码，试图找出每个文件和库的用途以及它们如何一起工作。通过这种方式，您将获得很多东西，例如jinja模板，oauth2等等的知识。

希望这会有所帮助。