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等等的知識。

希望這會有所幫助。