googleapis · chingor13 · Oct 22, 2019 · Oct 22, 2019
diff --git a/docs/_config.yml b/docs/_config.yml
@@ -0,0 +1,2 @@
+theme: jekyll-theme-dinky
+title: Google OAuth Client for Java
diff --git a/docs/_data/navigation.yml b/docs/_data/navigation.yml
@@ -0,0 +1,11 @@
+toc:
+  - page: Overview
+    url: index.html
+  - page: Setup Instructions
+    url: setup.html
+  - page: Component Modules
+    url: component-modules.html
+  - page: OAuth 1.0
+    url: oauth-1.0.html
+  - page: OAuth 2.0
+    url: oauth-2.0-html
diff --git a/docs/_layouts/default.html b/docs/_layouts/default.html
@@ -0,0 +1,54 @@
+<!doctype html>
+<html lang="{{ site.lang | default: "en-US" }}">
+  <head>
+    <meta charset="utf-8">
+    <meta http-equiv="X-UA-Compatible" content="IE=edge">
+
+{% seo %}
+    <link rel="stylesheet" href="{{ '/assets/css/style.css?v=' | append: site.github.build_revision | relative_url }}">
+    <script src="{{ '/assets/js/scale.fix.js' | relative_url }}"></script>
+    <meta name="viewport" content="width=device-width, initial-scale=1, user-scalable=no">
+    <!--[if lt IE 9]>
+    <script src="//html5shiv.googlecode.com/svn/trunk/html5.js"></script>
+    <![endif]-->
+  </head>
+  <body>
+    <div class="wrapper">
+      <header>
+        <h1 class="header">{{ site.title | default: site.github.repository_name }}</h1>
+
+        {% for entry in site.data.navigation.toc %}
+          <a href="{{ entry.url }}">{{ entry.page }}</a><br/>
+        {% endfor %}
+        <br/>
+
+        <ul>
+          {% if site.show_downloads %}
+            <li class="download"><a class="buttons" href="{{ site.github.zip_url }}">Download ZIP</a></li>
+            <li class="download"><a class="buttons" href="{{ site.github.tar_url }}">Download TAR</a></li>
+          {% endif %}
+          <li><a class="buttons github" href="{{ site.github.repository_url }}">View On GitHub</a></li>
+        </ul>
+      </header>
+
+      <section>
+        {{ content }}
+      </section>
+
+      <footer>
+        <p><small>Hosted on <a href="https://pages.github.com">GitHub Pages</a> using the Dinky theme</small></p>
+      </footer>
+    </div>
+    <!--[if !IE]><script>fixScale(document);</script><![endif]-->
+    {% if site.google_analytics %}
+      <script>
+        (function(i,s,o,g,r,a,m){i['GoogleAnalyticsObject']=r;i[r]=i[r]||function(){
+        (i[r].q=i[r].q||[]).push(arguments)},i[r].l=1*new Date();a=s.createElement(o),
+        m=s.getElementsByTagName(o)[0];a.async=1;a.src=g;m.parentNode.insertBefore(a,m)
+        })(window,document,'script','//www.google-analytics.com/analytics.js','ga');
+        ga('create', '{{ site.google_analytics }}', 'auto');
+        ga('send', 'pageview');
+      </script>
+    {% endif %}
+  </body>
+</html>
diff --git a/docs/component-modules.md b/docs/component-modules.md
@@ -0,0 +1,36 @@
+---
+title: Component Modules
+---
+
+# Component Modules
+
+This libraries is composed of several modules:
+
+## google-oauth-client
+
+Google OAuth Client Library for Java (`google-oauth-client`) is designed to be
+compatible with all supported Java platforms, including Android.
+
+## google-oauth-client-appengine
+
+Google App Engine extensions to the Google OAuth Client Library for Java
+(`google-oauth-client-appengine`) support Java Google App Engine applications.
+This module depends on `google-oauth-client` and `google-oauth-client-servlet`.
+
+## google-oauth-client-java6
+
+Java 6 (and higher) extensions to the Google OAuth Client Library for Java
+(`google-oauth-client-java6`) support Java6+ applications. This module depends
+on `google-oauth-client`.
+
+## google-oauth-client-jetty
+
+Jetty extensions to the Google OAuth Client Library for Java
+(`google-oauth-client-jetty`) support authorization code flow for installed
+applications. This module depends on `google-oauth-client-java6`.
+
+## google-oauth-client-servlet
+
+Servlet and JDO extensions to the Google OAuth Client Library for Java
+(`google-oauth-client-servlet`) support Java servlet web applications. This
+module depends on `google-oauth-client`.
diff --git a/docs/index.md b/docs/index.md
@@ -0,0 +1,44 @@
+---
+title: Overview
+---
+
+# Overview
+
+## Description
+
+Written by Google, the Google OAuth Client Library for Java is a
+powerful and easy-to-use Java library for the OAuth 1.0a and OAuth 2.0
+authorization standards.
+
+The Google OAuth Client Library for Java is designed to work with any
+OAuth service on the web, not just with Google APIs. The library is
+built on the [Google HTTP Client Library for Java][google-http-client],
+and it supports Java 7 (or higher) standard (SE) and enterprise (EE),
+Android 4.0 (or higher), and Google App Engine.
+
+For access to Google APIs, see the
+[Google API Client Library for Java][google-api-client].
+
+This is an open-source library, and you can access the
+[source on GitHub][google-oauth-client]. [Contributions][contributions] are
+welcome.
+
+## Beta Features
+
+Features marked with the `@Beta` annotation at the class or method level
+are subject to change. They might be modified in any way, or even removed,
+in any major release. You should not use beta features if your code is a
+library itself (that is, if your code is used on the `CLASSPATH` of users
+outside your own control).
+
+## Deprecated Features
+
+Deprecated non-beta features will be removed eighteen months after the
+release in which they are first deprecated. You must fix your usages before
+this time. If you don't, any type of breakage might result, and you are not
+guaranteed a compilation error.
+
+[google-http-client]: https://github.com/googleapis/google-http-java-client
+[google-api-client]: https://github.com/googleapis/google-api-java-client
+[google-oauth-client]: https://github.com/googleapis/google-oauth-java-client
+[contributions]: https://github.com/googleapis/google-oauth-java-client/blob/master/CONTRIBUTING.md
diff --git a/docs/oauth-1.0.md b/docs/oauth-1.0.md
@@ -0,0 +1,36 @@
+---
+title: OAuth 1.0
+---
+
+# OAuth 1.0a and the Google OAuth Client Library for Java
+
+[OAuth 1.0][oauth1] is a standard specification for allowing end users to
+securely authorize a client application to access protected server-side
+resources.
+
+## Important notices
+
+The OAuth 1.0a support provided by the Google OAuth Client Library for Java is
+`@Beta`.
+
+Do not use OAuth 1.0 to access Google APIs, because Google has deprecated its
+support for OAuth 1.0 in favor of OAuth 2.0. If you currently have an app that
+accesses Google APIs using OAuth 1.0, see
+[Migrating from OAuth 1.0 to OAuth 2.0][migrating].
+
+## Using OAuth 1.0
+
+The Google OAuth Client Library for Java supports two types of signature methods
+for OAuth 1.0a (`@Beta`), which we provide foruse with non-Google services:
+
+* HMAC-SHA1 ([`OAuthHmacSigner`][oauth-hmac-signer])
+* RSA-SHA1 ([`OAuthRsaSigner`][oauth-rsa-signer]
+
+For details, see the
+[Javadoc for the OAuth 1.0 package][oauth-javadoc].
+
+[oauth1]: http://tools.ietf.org/html/rfc5849
+[migrating]: https://developers.google.com/accounts/docs/OAuth_ref#migration
+[oauth-hmac-signer]: https://googleapis.dev/java/google-oauth-client/latest/com/google/api/client/auth/oauth/OAuthHmacSigner.html
+[oauth-rsa-signer]: https://googleapis.dev/java/google-oauth-client/latest/com/google/api/client/auth/oauth/OAuthRsaSigner.html
+[oauth-javadoc]: (https://googleapis.dev/java/google-oauth-client/latest/com/google/api/client/auth/oauth/package-summary.html)