Repository: kafka-site Updated Branches: refs/heads/asf-site 590fd7083 -> aa684e574
theme enhancements for mobile and branding guidelines rewrite rules added to prevent users from loading up html files meant to be partials add notification over past versions of docs and rename partials make subnav system and add required apache branding links added subnav for docs more branding guideline additions updated apache links removed random closing tag Project: http://git-wip-us.apache.org/repos/asf/kafka-site/repo Commit: http://git-wip-us.apache.org/repos/asf/kafka-site/commit/aa684e57 Tree: http://git-wip-us.apache.org/repos/asf/kafka-site/tree/aa684e57 Diff: http://git-wip-us.apache.org/repos/asf/kafka-site/diff/aa684e57 Branch: refs/heads/asf-site Commit: aa684e57475c9a68379de00378acab03a228eb6c Parents: 590fd70 Author: Derrick Or <[email protected]> Authored: Tue Oct 4 21:50:41 2016 -0700 Committer: Jason Gustafson <[email protected]> Committed: Wed Oct 5 18:26:54 2016 -0700 ---------------------------------------------------------------------- .htaccess | 6 +- 0100/documentation.html | 315 +++++++++++++++++++++-------------------- 0100/migration.html | 4 +- 0100/protocol.html | 17 ++- 0100/quickstart.html | 1 - 07/configuration.html | 4 +- 07/documentation.html | 12 +- 07/performance.html | 4 +- 07/quickstart.html | 4 +- 08/documentation.html | 12 +- 08/migration.html | 4 +- 081/documentation.html | 17 ++- 081/migration.html | 4 +- 082/documentation.html | 17 ++- 082/migration.html | 4 +- 090/documentation.html | 17 ++- 090/migration.html | 4 +- 090/protocol.html | 4 +- code.html | 8 +- coding-guide.html | 8 +- committers.html | 8 +- contact.html | 8 +- contributing.html | 8 +- documentation.html | 15 +- downloads.html | 12 +- images/logo.png | Bin 16171 -> 16613 bytes includes/_docs_banner.htm | 3 + includes/_docs_footer.htm | 9 ++ includes/_footer.htm | 83 +++++++++++ includes/_header.htm | 21 +++ includes/_nav.htm | 53 +++++++ includes/_top.htm | 5 + includes/footer.html | 49 ------- includes/header.html | 21 --- includes/nav.html | 34 ----- includes/top.html | 5 - index.html | 8 +- intro.html | 8 +- performance.html | 8 +- project-security.html | 8 +- project.html | 20 +-- quickstart.html | 14 +- styles.css | 123 ++++++++++++++-- uses.html | 8 +- 44 files changed, 588 insertions(+), 409 deletions(-) ---------------------------------------------------------------------- http://git-wip-us.apache.org/repos/asf/kafka-site/blob/aa684e57/.htaccess ---------------------------------------------------------------------- diff --git a/.htaccess b/.htaccess index 852be3d..8ecf1c2 100644 --- a/.htaccess +++ b/.htaccess @@ -1,4 +1,8 @@ Options +Includes +RewriteEngine On AddType text/html .html AddHandler server-parsed .html -Redirect 301 /design.html /documentation.html#design \ No newline at end of file +Redirect 301 /design.html /documentation#design + +RewriteRule ^/?(\d+)/documentation(\.html)? - [S=1] +RewriteRule ^/?(\d+)/([a-z]+)(\.html)? /$1/documentation#$2 [R=302,L,NE] http://git-wip-us.apache.org/repos/asf/kafka-site/blob/aa684e57/0100/documentation.html ---------------------------------------------------------------------- diff --git a/0100/documentation.html b/0100/documentation.html index b20c0de..85a9701 100644 --- a/0100/documentation.html +++ b/0100/documentation.html @@ -15,177 +15,186 @@ limitations under the License. --> -<h3>Kafka 0.10.0</h3> -Prior releases: <a href="/07/documentation.html">0.7.x</a>, <a href="/08/documentation.html">0.8.0</a>, <a href="/081/documentation.html">0.8.1.X</a>, <a href="/082/documentation.html">0.8.2.X</a>, <a href="/090/documentation.html">0.9.0.X</a>. -</ul> - -<ul class="toc"> - <li><a href="#gettingStarted">1. Getting Started</a> - <ul> - <li><a href="#introduction">1.1 Introduction</a> - <li><a href="#uses">1.2 Use Cases</a> - <li><a href="#quickstart">1.3 Quick Start</a> - <li><a href="#ecosystem">1.4 Ecosystem</a> - <li><a href="#upgrade">1.5 Upgrading</a> - </ul> - </li> - <li><a href="#api">2. APIs</a> - <ul> - <li><a href="#producerapi">2.1 Producer API</a> - <li><a href="#consumerapi">2.2 Consumer API</a> - <li><a href="#streamsapi">2.3 Streams API</a> - <li><a href="#connectapi">2.4 Connect API</a> - <li><a href="#legacyapis">2.5 Legacy APIs</a> - </ul> - </li> - <li><a href="#configuration">3. Configuration</a> - <ul> - <li><a href="#brokerconfigs">3.1 Broker Configs</a> - <li><a href="#producerconfigs">3.2 Producer Configs</a> - <li><a href="#consumerconfigs">3.3 Consumer Configs</a> - <ul> - <li><a href="#oldconsumerconfigs">3.3.1 Old Consumer Configs</a> - <li><a href="#newconsumerconfigs">3.3.2 New Consumer Configs</a> - </ul> - <li><a href="#connectconfigs">3.4 Kafka Connect Configs</a> - <li><a href="#streamsconfigs">3.5 Kafka Streams Configs</a> - </ul> - </li> - <li><a href="#design">4. Design</a> - <ul> - <li><a href="#majordesignelements">4.1 Motivation</a> - <li><a href="#persistence">4.2 Persistence</a> - <li><a href="#maximizingefficiency">4.3 Efficiency</a> - <li><a href="#theproducer">4.4 The Producer</a> - <li><a href="#theconsumer">4.5 The Consumer</a> - <li><a href="#semantics">4.6 Message Delivery Semantics</a> - <li><a href="#replication">4.7 Replication</a> - <li><a href="#compaction">4.8 Log Compaction</a> - <li><a href="#design_quotas">4.9 Quotas</a> - </ul> - </li> - <li><a href="#implementation">5. Implementation</a> - <ul> - <li><a href="#apidesign">5.1 API Design</a> - <li><a href="#networklayer">5.2 Network Layer</a> - <li><a href="#messages">5.3 Messages</a> - <li><a href="#messageformat">5.4 Message format</a> - <li><a href="#log">5.5 Log</a> - <li><a href="#distributionimpl">5.6 Distribution</a> - </ul> - </li> - <li><a href="#operations">6. Operations</a> - <ul> - <li><a href="#basic_ops">6.1 Basic Kafka Operations</a> - <ul> - <li><a href="#basic_ops_add_topic">Adding and removing topics</a> - <li><a href="#basic_ops_modify_topic">Modifying topics</a> - <li><a href="#basic_ops_restarting">Graceful shutdown</a> - <li><a href="#basic_ops_leader_balancing">Balancing leadership</a> - <li><a href="#basic_ops_consumer_lag">Checking consumer position</a> - <li><a href="#basic_ops_mirror_maker">Mirroring data between clusters</a> - <li><a href="#basic_ops_cluster_expansion">Expanding your cluster</a> - <li><a href="#basic_ops_decommissioning_brokers">Decommissioning brokers</a> - <li><a href="#basic_ops_increase_replication_factor">Increasing replication factor</a> - </ul> - <li><a href="#datacenters">6.2 Datacenters</a> - <li><a href="#config">6.3 Important Configs</a> - <ul> - <li><a href="#serverconfig">Important Server Configs</a> - <li><a href="#clientconfig">Important Client Configs</a> - <li><a href="#prodconfig">A Production Server Configs</a> - </ul> - <li><a href="#java">6.4 Java Version</a> - <li><a href="#hwandos">6.5 Hardware and OS</a> - <ul> - <li><a href="#os">OS</a> - <li><a href="#diskandfs">Disks and Filesystems</a> - <li><a href="#appvsosflush">Application vs OS Flush Management</a> - <li><a href="#linuxflush">Linux Flush Behavior</a> - <li><a href="#ext4">Ext4 Notes</a> - </ul> - <li><a href="#monitoring">6.6 Monitoring</a> - <li><a href="#zk">6.7 ZooKeeper</a> +<!--#include virtual="../includes/_header.htm" --> +<!--#include virtual="../includes/_top.htm" --> +<div class="content documentation documentation--current"> + <!--#include virtual="../includes/_nav.htm" --> + <div class="right"> + <!--#include virtual="../includes/_docs_banner.htm" --> + <h1>Documentation</h1> + <h3>Kafka 0.10.0</h3> + <p> + Prior releases: <a href="/07/documentation.html">0.7.x</a>, <a href="/08/documentation.html">0.8.0</a>, <a href="/081/documentation.html">0.8.1.X</a>, <a href="/082/documentation.html">0.8.2.X</a>, <a href="/090/documentation.html">0.9.0.X</a>. + </p> + + <ul class="toc"> + <li><a href="#gettingStarted">1. Getting Started</a> + <ul> + <li><a href="#introduction">1.1 Introduction</a> + <li><a href="#uses">1.2 Use Cases</a> + <li><a href="#quickstart">1.3 Quick Start</a> + <li><a href="#ecosystem">1.4 Ecosystem</a> + <li><a href="#upgrade">1.5 Upgrading</a> + </ul> + </li> + <li><a href="#api">2. APIs</a> + <ul> + <li><a href="#producerapi">2.1 Producer API</a> + <li><a href="#consumerapi">2.2 Consumer API</a> + <li><a href="#streamsapi">2.3 Streams API</a> + <li><a href="#connectapi">2.4 Connect API</a> + <li><a href="#legacyapis">2.5 Legacy APIs</a> + </ul> + </li> + <li><a href="#configuration">3. Configuration</a> + <ul> + <li><a href="#brokerconfigs">3.1 Broker Configs</a> + <li><a href="#producerconfigs">3.2 Producer Configs</a> + <li><a href="#consumerconfigs">3.3 Consumer Configs</a> + <ul> + <li><a href="#oldconsumerconfigs">3.3.1 Old Consumer Configs</a> + <li><a href="#newconsumerconfigs">3.3.2 New Consumer Configs</a> + </ul> + <li><a href="#connectconfigs">3.4 Kafka Connect Configs</a> + <li><a href="#streamsconfigs">3.5 Kafka Streams Configs</a> + </ul> + </li> + <li><a href="#design">4. Design</a> + <ul> + <li><a href="#majordesignelements">4.1 Motivation</a> + <li><a href="#persistence">4.2 Persistence</a> + <li><a href="#maximizingefficiency">4.3 Efficiency</a> + <li><a href="#theproducer">4.4 The Producer</a> + <li><a href="#theconsumer">4.5 The Consumer</a> + <li><a href="#semantics">4.6 Message Delivery Semantics</a> + <li><a href="#replication">4.7 Replication</a> + <li><a href="#compaction">4.8 Log Compaction</a> + <li><a href="#design_quotas">4.9 Quotas</a> + </ul> + </li> + <li><a href="#implementation">5. Implementation</a> + <ul> + <li><a href="#apidesign">5.1 API Design</a> + <li><a href="#networklayer">5.2 Network Layer</a> + <li><a href="#messages">5.3 Messages</a> + <li><a href="#messageformat">5.4 Message format</a> + <li><a href="#log">5.5 Log</a> + <li><a href="#distributionimpl">5.6 Distribution</a> + </ul> + </li> + <li><a href="#operations">6. Operations</a> + <ul> + <li><a href="#basic_ops">6.1 Basic Kafka Operations</a> + <ul> + <li><a href="#basic_ops_add_topic">Adding and removing topics</a> + <li><a href="#basic_ops_modify_topic">Modifying topics</a> + <li><a href="#basic_ops_restarting">Graceful shutdown</a> + <li><a href="#basic_ops_leader_balancing">Balancing leadership</a> + <li><a href="#basic_ops_consumer_lag">Checking consumer position</a> + <li><a href="#basic_ops_mirror_maker">Mirroring data between clusters</a> + <li><a href="#basic_ops_cluster_expansion">Expanding your cluster</a> + <li><a href="#basic_ops_decommissioning_brokers">Decommissioning brokers</a> + <li><a href="#basic_ops_increase_replication_factor">Increasing replication factor</a> + </ul> + <li><a href="#datacenters">6.2 Datacenters</a> + <li><a href="#config">6.3 Important Configs</a> + <ul> + <li><a href="#serverconfig">Important Server Configs</a> + <li><a href="#clientconfig">Important Client Configs</a> + <li><a href="#prodconfig">A Production Server Configs</a> + </ul> + <li><a href="#java">6.4 Java Version</a> + <li><a href="#hwandos">6.5 Hardware and OS</a> + <ul> + <li><a href="#os">OS</a> + <li><a href="#diskandfs">Disks and Filesystems</a> + <li><a href="#appvsosflush">Application vs OS Flush Management</a> + <li><a href="#linuxflush">Linux Flush Behavior</a> + <li><a href="#ext4">Ext4 Notes</a> + </ul> + <li><a href="#monitoring">6.6 Monitoring</a> + <li><a href="#zk">6.7 ZooKeeper</a> + <ul> + <li><a href="#zkversion">Stable Version</a> + <li><a href="#zkops">Operationalization</a> + </ul> + </ul> + </li> + <li><a href="#security">7. Security</a> + <ul> + <li><a href="#security_overview">7.1 Security Overview</a></li> + <li><a href="#security_ssl">7.2 Encryption and Authentication using SSL</a></li> + <li><a href="#security_sasl">7.3 Authentication using SASL</a></li> + <li><a href="#security_authz">7.4 Authorization and ACLs</a></li> + <li><a href="#security_rolling_upgrade">7.5 Incorporating Security Features in a Running Cluster</a></li> + <li><a href="#zk_authz">7.6 ZooKeeper Authentication</a></li> <ul> - <li><a href="#zkversion">Stable Version</a> - <li><a href="#zkops">Operationalization</a> + <li><a href="#zk_authz_new">New Clusters</a></li> + <li><a href="#zk_authz_migration">Migrating Clusters</a></li> + <li><a href="#zk_authz_ensemble">Migrating the ZooKeeper Ensemble</a></li> </ul> - </ul> - </li> - <li><a href="#security">7. Security</a> - <ul> - <li><a href="#security_overview">7.1 Security Overview</a></li> - <li><a href="#security_ssl">7.2 Encryption and Authentication using SSL</a></li> - <li><a href="#security_sasl">7.3 Authentication using SASL</a></li> - <li><a href="#security_authz">7.4 Authorization and ACLs</a></li> - <li><a href="#security_rolling_upgrade">7.5 Incorporating Security Features in a Running Cluster</a></li> - <li><a href="#zk_authz">7.6 ZooKeeper Authentication</a></li> + </ul> + </li> + <li><a href="#connect">8. Kafka Connect</a> <ul> - <li><a href="#zk_authz_new">New Clusters</a></li> - <li><a href="#zk_authz_migration">Migrating Clusters</a></li> - <li><a href="#zk_authz_ensemble">Migrating the ZooKeeper Ensemble</a></li> + <li><a href="#connect_overview">8.1 Overview</a></li> + <li><a href="#connect_user">8.2 User Guide</a></li> + <li><a href="#connect_development">8.3 Connector Development Guide</a></li> </ul> - </ul> - </li> - <li><a href="#connect">8. Kafka Connect</a> - <ul> - <li><a href="#connect_overview">8.1 Overview</a></li> - <li><a href="#connect_user">8.2 User Guide</a></li> - <li><a href="#connect_development">8.3 Connector Development Guide</a></li> - </ul> - </li> - <li><a href="#streams">9. Kafka Streams</a> - <ul> - <li><a href="#streams_overview">9.1 Overview</a></li> - <li><a href="#streams_developer">9.2 Developer Guide</a></li> + </li> + <li><a href="#streams">9. Kafka Streams</a> <ul> - <li><a href="#streams_concepts">Core Concepts</a></li> - <li><a href="#streams_processor">Low-Level Processor API</a></li> - <li><a href="#streams_dsl">High-Level Streams DSL</a></li> + <li><a href="#streams_overview">9.1 Overview</a></li> + <li><a href="#streams_developer">9.2 Developer Guide</a></li> + <ul> + <li><a href="#streams_concepts">Core Concepts</a></li> + <li><a href="#streams_processor">Low-Level Processor API</a></li> + <li><a href="#streams_dsl">High-Level Streams DSL</a></li> + </ul> </ul> - </ul> - </li> -</ul> + </li> + </ul> -<h2><a id="gettingStarted" href="#gettingStarted">1. Getting Started</a></h2> - <h3><a id="introduction" href="#introduction">1.1 Introduction</a></h3> - <!--#include virtual="introduction.html" --> - <h3><a id="uses" href="#uses">1.2 Use Cases</a></h3> - <!--#include virtual="uses.html" --> - <h3><a id="quickstart" href="#quickstart">1.3 Quick Start</a></h3> - <!--#include virtual="quickstart.html" --> - <h3><a id="ecosystem" href="#ecosystem">1.4 Ecosystem</a></h3> - <!--#include virtual="ecosystem.html" --> - <h3><a id="upgrade" href="#upgrade">1.5 Upgrading From Previous Versions</a></h3> - <!--#include virtual="upgrade.html" --> + <h2><a id="gettingStarted" href="#gettingStarted">1. Getting Started</a></h2> + <h3><a id="introduction" href="#introduction">1.1 Introduction</a></h3> + <!--#include virtual="introduction.html" --> + <h3><a id="uses" href="#uses">1.2 Use Cases</a></h3> + <!--#include virtual="uses.html" --> + <h3><a id="quickstart" href="#quickstart">1.3 Quick Start</a></h3> + <!--#include virtual="quickstart.html" --> + <h3><a id="ecosystem" href="#ecosystem">1.4 Ecosystem</a></h3> + <!--#include virtual="ecosystem.html" --> + <h3><a id="upgrade" href="#upgrade">1.5 Upgrading From Previous Versions</a></h3> + <!--#include virtual="upgrade.html" --> -<h2><a id="api" href="#api">2. APIs</a></h2> + <h2><a id="api" href="#api">2. APIs</a></h2> -<!--#include virtual="api.html" --> + <!--#include virtual="api.html" --> -<h2><a id="configuration" href="#configuration">3. Configuration</a></h2> + <h2><a id="configuration" href="#configuration">3. Configuration</a></h2> -<!--#include virtual="configuration.html" --> + <!--#include virtual="configuration.html" --> -<h2><a id="design" href="#design">4. Design</a></h2> + <h2><a id="design" href="#design">4. Design</a></h2> -<!--#include virtual="design.html" --> + <!--#include virtual="design.html" --> -<h2><a id="implementation" href="#implementation">5. Implementation</a></h2> + <h2><a id="implementation" href="#implementation">5. Implementation</a></h2> -<!--#include virtual="implementation.html" --> + <!--#include virtual="implementation.html" --> -<h2><a id="operations" href="#operations">6. Operations</a></h2> + <h2><a id="operations" href="#operations">6. Operations</a></h2> -<!--#include virtual="ops.html" --> + <!--#include virtual="ops.html" --> -<h2><a id="security" href="#security">7. Security</a></h2> -<!--#include virtual="security.html" --> + <h2><a id="security" href="#security">7. Security</a></h2> + <!--#include virtual="security.html" --> -<h2><a id="connect" href="#connect">8. Kafka Connect</a></h2> -<!--#include virtual="connect.html" --> + <h2><a id="connect" href="#connect">8. Kafka Connect</a></h2> + <!--#include virtual="connect.html" --> -<h2><a id="streams" href="#streams">9. Kafka Streams</a></h2> -<!--#include virtual="streams.html" --> + <h2><a id="streams" href="#streams">9. Kafka Streams</a></h2> + <!--#include virtual="streams.html" --> -<!--#include virtual="../includes/footer.html" --> +<!--#include virtual="../includes/_footer.htm" --> +<!--#include virtual="../includes/_docs_footer.htm" --> http://git-wip-us.apache.org/repos/asf/kafka-site/blob/aa684e57/0100/migration.html ---------------------------------------------------------------------- diff --git a/0100/migration.html b/0100/migration.html index 5240d86..08a6271 100644 --- a/0100/migration.html +++ b/0100/migration.html @@ -15,7 +15,7 @@ limitations under the License. --> -<!--#include virtual="../includes/header.html" --> +<!--#include virtual="../includes/_header.htm" --> <h2><a id="migration" href="#migration">Migrating from 0.7.x to 0.8</a></h2> 0.8 is our first (and hopefully last) release with a non-backwards-compatible wire protocol, ZooKeeper layout, and on-disk data format. This was a chance for us to clean up a lot of cruft and start fresh. This means performing a no-downtime upgrade is more painful than normal—you cannot just swap in the new code in-place. @@ -31,4 +31,4 @@ <li>Drink. </ol> -<!--#include virtual="../includes/footer.html" --> +<!--#include virtual="../includes/_footer.htm" --> http://git-wip-us.apache.org/repos/asf/kafka-site/blob/aa684e57/0100/protocol.html ---------------------------------------------------------------------- diff --git a/0100/protocol.html b/0100/protocol.html index 5b1dd0b..642e566 100644 --- a/0100/protocol.html +++ b/0100/protocol.html @@ -15,10 +15,10 @@ limitations under the License. --> -<!--#include virtual="../includes/header.html" --> -<!--#include virtual="../includes/top.html" --> +<!--#include virtual="../includes/_header.htm" --> +<!--#include virtual="../includes/_top.htm" --> <div class="content"> - <!--#include virtual="../includes/nav.html" --> + <!--#include virtual="../includes/_nav.htm" --> <div class="right"> <h1>Kafka protocol guide</h1> <p>This document covers the wire protocol implemented in Kafka. It is meant to give a readable guide to the protocol that covers the available requests, their binary format, and the proper way to make use of them to implement a client. This document assumes you understand the basic design and terminology described <a href="https://kafka.apache.org/documentation.html#design";>here</a></p> @@ -222,9 +222,8 @@ <p>A final question is why we don't use a system like Protocol Buffers or Thrift to define our request messages. These packages excel at helping you to managing lots and lots of serialized messages. However we have only a few messages. Support across languages is somewhat spotty (depending on the package). Finally the mapping between binary log format and wire protocol is something we manage somewhat carefully and this would not be possible with these systems. Finally we prefer the style of versioning APIs explicitly and checking this to inferring new values as nulls as it allows more nuanced control of compatibility.</p> - <script> - // Show selected style on nav item - $(function() { $('.b-nav__project').addClass('selected'); }); - </script> - -<!--#include virtual="../includes/footer.html" --> +<!--#include virtual="../includes/_footer.htm" --> +<script> +// Show selected style on nav item +$(function() { $('.b-nav__project').addClass('selected'); }); +</script> http://git-wip-us.apache.org/repos/asf/kafka-site/blob/aa684e57/0100/quickstart.html ---------------------------------------------------------------------- diff --git a/0100/quickstart.html b/0100/quickstart.html index fc3e765..bf710e0 100644 --- a/0100/quickstart.html +++ b/0100/quickstart.html @@ -14,7 +14,6 @@ See the License for the specific language governing permissions and limitations under the License. --> - <p>This tutorial assumes you are starting fresh and have no existing Kafka or ZooKeeper data.</p> <h4><a id="quickstart_download" href="#quickstart_download">Step 1: Download the code</a></h4> http://git-wip-us.apache.org/repos/asf/kafka-site/blob/aa684e57/07/configuration.html ---------------------------------------------------------------------- diff --git a/07/configuration.html b/07/configuration.html index 4420560..92fb139 100644 --- a/07/configuration.html +++ b/07/configuration.html @@ -1,4 +1,4 @@ -<!--#include virtual="../includes/header.html" --> +<!--#include virtual="../includes/_header.htm" --> <h2> Configuration </h2> @@ -352,4 +352,4 @@ the size of those queues</td> </table> -<!--#include virtual="../includes/footer.html" --> +<!--#include virtual="../includes/_footer.htm" --> http://git-wip-us.apache.org/repos/asf/kafka-site/blob/aa684e57/07/documentation.html ---------------------------------------------------------------------- diff --git a/07/documentation.html b/07/documentation.html index 6125857..bb35352 100644 --- a/07/documentation.html +++ b/07/documentation.html @@ -1,8 +1,9 @@ -<!--#include virtual="../includes/header.html" --> -<!--#include virtual="../includes/top.html" --> -<div class="content"> - <!--#include virtual="../includes/nav.html" --> +<!--#include virtual="../includes/_header.htm" --> +<!--#include virtual="../includes/_top.htm" --> +<div class="content documentation"> + <!--#include virtual="../includes/_nav.htm" --> <div class="right"> + <!--#include virtual="../includes/_docs_banner.htm" --> <h1>Documentation</h1> <h3>Kafka 0.7</h3> @@ -14,4 +15,5 @@ <li><a href="http://people.apache.org/~joestein/kafka-0.7.1-incubating-docs";>API Docs</a> – Scaladoc for the api. </ul> -<!--#include virtual="../includes/footer.html" --> +<!--#include virtual="../includes/_footer.htm" --> +<!--#include virtual="../includes/_docs_footer.htm" --> http://git-wip-us.apache.org/repos/asf/kafka-site/blob/aa684e57/07/performance.html ---------------------------------------------------------------------- diff --git a/07/performance.html b/07/performance.html index 78fc254..e1c8420 100644 --- a/07/performance.html +++ b/07/performance.html @@ -1,4 +1,4 @@ -<!--#include virtual="../includes/header.html" --> +<!--#include virtual="../includes/_header.htm" --> <h2>Performance Results</h2> <p>The following tests give some basic information on Kafka throughput as the number of topics, consumers and producers and overall data size varies. Since Kafka nodes are independent, these tests are run with a single producer, consumer, and broker machine. Results can be extrapolated for a larger cluster. @@ -80,4 +80,4 @@ The below graph is an experiment where we used 40 producers and varied the numbe <p>The charts similar to above graphs can be plotted with report.html automatically.</p> -<!--#include virtual="../includes/footer.html" --> +<!--#include virtual="../includes/_footer.htm" --> http://git-wip-us.apache.org/repos/asf/kafka-site/blob/aa684e57/07/quickstart.html ---------------------------------------------------------------------- diff --git a/07/quickstart.html b/07/quickstart.html index 256fcbd..51e61ad 100644 --- a/07/quickstart.html +++ b/07/quickstart.html @@ -1,4 +1,4 @@ -<!--#include virtual="../includes/header.html" --> +<!--#include virtual="../includes/_header.htm" --> <h2>Quick Start</h2> @@ -306,4 +306,4 @@ while (true) { } </pre> -<!--#include virtual="../includes/footer.html" --> \ No newline at end of file +<!--#include virtual="../includes/_footer.htm" --> \ No newline at end of file http://git-wip-us.apache.org/repos/asf/kafka-site/blob/aa684e57/08/documentation.html ---------------------------------------------------------------------- diff --git a/08/documentation.html b/08/documentation.html index 1404239..e794dc6 100644 --- a/08/documentation.html +++ b/08/documentation.html @@ -1,8 +1,9 @@ -<!--#include virtual="../includes/header.html" --> -<!--#include virtual="../includes/top.html" --> -<div class="content"> - <!--#include virtual="../includes/nav.html" --> +<!--#include virtual="../includes/_header.htm" --> +<!--#include virtual="../includes/_top.htm" --> +<div class="content documentation"> + <!--#include virtual="../includes/_nav.htm" --> <div class="right"> + <!--#include virtual="../includes/_docs_banner.htm" --> <h1>Documentation</h1> <h3>Kafka 0.8.0</h3> <i>Documentation for the 0.7 release is <a href="/07/documentation.html">here</a>.</i> @@ -102,4 +103,5 @@ <!--#include virtual="tools.html" --> -<!--#include virtual="../includes/footer.html" --> +<!--#include virtual="../includes/_footer.htm" --> +<!--#include virtual="../includes/_docs_footer.htm" --> http://git-wip-us.apache.org/repos/asf/kafka-site/blob/aa684e57/08/migration.html ---------------------------------------------------------------------- diff --git a/08/migration.html b/08/migration.html index b5d5a82..65624e7 100644 --- a/08/migration.html +++ b/08/migration.html @@ -1,4 +1,4 @@ -<!--#include virtual="../includes/header.html" --> +<!--#include virtual="../includes/_header.htm" --> <h2>Migrating from 0.7.x to 0.8</h2> 0.8 is our first (and hopefully last) release with a non-backwards-compatible wire protocol, zookeeper layout, and on-disk data format. This was a chance for us to clean up a lot of cruft and start fresh. This means performing a no-downtime upgrade is more painful than normal—you cannot just swap in the new code in-place. @@ -14,4 +14,4 @@ <li>Drink. </ol> -<!--#include virtual="../includes/footer.html" --> \ No newline at end of file +<!--#include virtual="../includes/_footer.htm" --> \ No newline at end of file http://git-wip-us.apache.org/repos/asf/kafka-site/blob/aa684e57/081/documentation.html ---------------------------------------------------------------------- diff --git a/081/documentation.html b/081/documentation.html index 7fbb41d..5ccb7ea 100644 --- a/081/documentation.html +++ b/081/documentation.html @@ -1,12 +1,14 @@ -<!--#include virtual="../includes/header.html" --> -<!--#include virtual="../includes/top.html" --> -<div class="content"> - <!--#include virtual="../includes/nav.html" --> +<!--#include virtual="../includes/_header.htm" --> +<!--#include virtual="../includes/_top.htm" --> +<div class="content documentation"> + <!--#include virtual="../includes/_nav.htm" --> <div class="right"> + <!--#include virtual="../includes/_docs_banner.htm" --> <h1>Documentation</h1> <h3>Kafka 0.8.1</h3> - Prior releases: <a href="/07/documentation.html">0.7.x</a>, <a href="/08/documentation.html">0.8.0</a>. - </ul> + <p> + Prior releases: <a href="/07/documentation.html">0.7.x</a>, <a href="/08/documentation.html">0.8.0</a>. + </p> <ul class="toc"> <li><a href="#gettingStarted">1. Getting Started</a> @@ -117,4 +119,5 @@ <!--#include virtual="ops.html" --> -<!--#include virtual="../includes/footer.html" --> +<!--#include virtual="../includes/_footer.htm" --> +<!--#include virtual="../includes/_docs_footer.htm" --> http://git-wip-us.apache.org/repos/asf/kafka-site/blob/aa684e57/081/migration.html ---------------------------------------------------------------------- diff --git a/081/migration.html b/081/migration.html index 922415c..9447c30 100644 --- a/081/migration.html +++ b/081/migration.html @@ -1,4 +1,4 @@ -<!--#include virtual="../includes/header.html" --> +<!--#include virtual="../includes/_header.htm" --> <h2>Migrating from 0.7.x to 0.8</h2> 0.8 is our first (and hopefully last) release with a non-backwards-compatible wire protocol, ZooKeeper layout, and on-disk data format. This was a chance for us to clean up a lot of cruft and start fresh. This means performing a no-downtime upgrade is more painful than normal—you cannot just swap in the new code in-place. @@ -14,4 +14,4 @@ <li>Drink. </ol> -<!--#include virtual="../includes/footer.html" --> \ No newline at end of file +<!--#include virtual="../includes/_footer.htm" --> \ No newline at end of file http://git-wip-us.apache.org/repos/asf/kafka-site/blob/aa684e57/082/documentation.html ---------------------------------------------------------------------- diff --git a/082/documentation.html b/082/documentation.html index 6c6aea9..2dcf738 100644 --- a/082/documentation.html +++ b/082/documentation.html @@ -1,12 +1,14 @@ -<!--#include virtual="../includes/header.html" --> -<!--#include virtual="../includes/top.html" --> -<div class="content"> - <!--#include virtual="../includes/nav.html" --> +<!--#include virtual="../includes/_header.htm" --> +<!--#include virtual="../includes/_top.htm" --> +<div class="content documentation"> + <!--#include virtual="../includes/_nav.htm" --> <div class="right"> + <!--#include virtual="../includes/_docs_banner.htm" --> <h1>Documentation</h1> <h3>Kafka 0.8.2</h3> - Prior releases: <a href="/07/documentation.html">0.7.x</a>, <a href="/08/documentation.html">0.8.0</a>, <a href="/081/documentation.html">0.8.1.X</a>. - </ul> + <p> + Prior releases: <a href="/07/documentation.html">0.7.x</a>, <a href="/08/documentation.html">0.8.0</a>, <a href="/081/documentation.html">0.8.1.X</a>. + </p> <ul class="toc"> <li><a href="#gettingStarted">1. Getting Started</a> @@ -117,4 +119,5 @@ <!--#include virtual="ops.html" --> -<!--#include virtual="../includes/footer.html" --> +<!--#include virtual="../includes/_footer.htm" --> +<!--#include virtual="../includes/_docs_footer.htm" --> http://git-wip-us.apache.org/repos/asf/kafka-site/blob/aa684e57/082/migration.html ---------------------------------------------------------------------- diff --git a/082/migration.html b/082/migration.html index 922415c..9447c30 100644 --- a/082/migration.html +++ b/082/migration.html @@ -1,4 +1,4 @@ -<!--#include virtual="../includes/header.html" --> +<!--#include virtual="../includes/_header.htm" --> <h2>Migrating from 0.7.x to 0.8</h2> 0.8 is our first (and hopefully last) release with a non-backwards-compatible wire protocol, ZooKeeper layout, and on-disk data format. This was a chance for us to clean up a lot of cruft and start fresh. This means performing a no-downtime upgrade is more painful than normal—you cannot just swap in the new code in-place. @@ -14,4 +14,4 @@ <li>Drink. </ol> -<!--#include virtual="../includes/footer.html" --> \ No newline at end of file +<!--#include virtual="../includes/_footer.htm" --> \ No newline at end of file http://git-wip-us.apache.org/repos/asf/kafka-site/blob/aa684e57/090/documentation.html ---------------------------------------------------------------------- diff --git a/090/documentation.html b/090/documentation.html index bae0652..60e42a2 100644 --- a/090/documentation.html +++ b/090/documentation.html @@ -15,15 +15,17 @@ limitations under the License. --> -<!--#include virtual="../includes/header.html" --> -<!--#include virtual="../includes/top.html" --> -<div class="content"> - <!--#include virtual="../includes/nav.html" --> +<!--#include virtual="../includes/_header.htm" --> +<!--#include virtual="../includes/_top.htm" --> +<div class="content documentation"> + <!--#include virtual="../includes/_nav.htm" --> <div class="right"> + <!--#include virtual="../includes/_docs_banner.htm" --> <h1>Documentation</h1> <h3>Kafka 0.9.0</h3> - Prior releases: <a href="/07/documentation.html">0.7.x</a>, <a href="/08/documentation.html">0.8.0</a>, <a href="/081/documentation.html">0.8.1.X</a>, <a href="/082/documentation.html">0.8.2.X</a>. - </ul> + <p> + Prior releases: <a href="/07/documentation.html">0.7.x</a>, <a href="/08/documentation.html">0.8.0</a>, <a href="/081/documentation.html">0.8.1.X</a>, <a href="/082/documentation.html">0.8.2.X</a>. + </p> <ul class="toc"> <li><a href="#gettingStarted">1. Getting Started</a> @@ -175,4 +177,5 @@ <h2><a id="connect" href="#connect">8. Kafka Connect</a></h2> <!--#include virtual="connect.html" --> -<!--#include virtual="../includes/footer.html" --> +<!--#include virtual="../includes/_footer.htm" --> +<!--#include virtual="../includes/_docs_footer.htm" --> http://git-wip-us.apache.org/repos/asf/kafka-site/blob/aa684e57/090/migration.html ---------------------------------------------------------------------- diff --git a/090/migration.html b/090/migration.html index 2da6a7e..291aab0 100644 --- a/090/migration.html +++ b/090/migration.html @@ -15,7 +15,7 @@ limitations under the License. --> -<!--#include virtual="../includes/header.html" --> +<!--#include virtual="../includes/_header.htm" --> <h2><a id="migration" href="#migration">Migrating from 0.7.x to 0.8</a></h2> 0.8 is our first (and hopefully last) release with a non-backwards-compatible wire protocol, ZooKeeper layout, and on-disk data format. This was a chance for us to clean up a lot of cruft and start fresh. This means performing a no-downtime upgrade is more painful than normal—you cannot just swap in the new code in-place. @@ -31,4 +31,4 @@ <li>Drink. </ol> -<!--#include virtual="../includes/footer.html" --> +<!--#include virtual="../includes/_footer.htm" --> http://git-wip-us.apache.org/repos/asf/kafka-site/blob/aa684e57/090/protocol.html ---------------------------------------------------------------------- diff --git a/090/protocol.html b/090/protocol.html index cb359f1..f38da96 100644 --- a/090/protocol.html +++ b/090/protocol.html @@ -15,7 +15,7 @@ limitations under the License. --> -<!--#include virtual="../includes/header.html" --> +<!--#include virtual="../includes/_header.htm" --> <h3><a id="protocol" href="#protocol">Kafka Wire Protocol</a></h3> @@ -179,4 +179,4 @@ Size => int32 <p>A final question is why we don't use a system like Protocol Buffers or Thrift to define our request messages. These packages excel at helping you to managing lots and lots of serialized messages. However we have only a few messages. Support across languages is somewhat spotty (depending on the package). Finally the mapping between binary log format and wire protocol is something we manage somewhat carefully and this would not be possible with these systems. Finally we prefer the style of versioning APIs explicitly and checking this to inferring new values as nulls as it allows more nuanced control of compatibility.</p> -<!--#include virtual="../includes/footer.html" --> +<!--#include virtual="../includes/_footer.htm" --> http://git-wip-us.apache.org/repos/asf/kafka-site/blob/aa684e57/code.html ---------------------------------------------------------------------- diff --git a/code.html b/code.html index 812de9f..063ad5e 100644 --- a/code.html +++ b/code.html @@ -1,7 +1,7 @@ -<!--#include virtual="includes/header.html" --> -<!--#include virtual="includes/top.html" --> +<!--#include virtual="includes/_header.htm" --> +<!--#include virtual="includes/_top.htm" --> <div class="content"> - <!--#include virtual="includes/nav.html" --> + <!--#include virtual="includes/_nav.htm" --> <div class="right"> <h1>Getting the code</h1> <p> @@ -28,4 +28,4 @@ $(function() { $('.b-nav__project').addClass('selected'); }); </script> -<!--#include virtual="includes/footer.html" --> +<!--#include virtual="includes/_footer.htm" --> http://git-wip-us.apache.org/repos/asf/kafka-site/blob/aa684e57/coding-guide.html ---------------------------------------------------------------------- diff --git a/coding-guide.html b/coding-guide.html index c94a0eb..bfdacc7 100644 --- a/coding-guide.html +++ b/coding-guide.html @@ -1,7 +1,7 @@ -<!--#include virtual="includes/header.html" --> -<!--#include virtual="includes/top.html" --> +<!--#include virtual="includes/_header.htm" --> +<!--#include virtual="includes/_top.htm" --> <div class="content"> - <!--#include virtual="includes/nav.html" --> + <!--#include virtual="includes/_nav.htm" --> <div class="right"> <h1>Coding guidelines</h1> <p> @@ -107,4 +107,4 @@ $(function() { $('.b-nav__project').addClass('selected'); }); </script> -<!--#include virtual="includes/footer.html" --> +<!--#include virtual="includes/_footer.htm" --> http://git-wip-us.apache.org/repos/asf/kafka-site/blob/aa684e57/committers.html ---------------------------------------------------------------------- diff --git a/committers.html b/committers.html index 66e7155..4d6c392 100644 --- a/committers.html +++ b/committers.html @@ -1,7 +1,7 @@ -<!--#include virtual="includes/header.html" --> -<!--#include virtual="includes/top.html" --> +<!--#include virtual="includes/_header.htm" --> +<!--#include virtual="includes/_top.htm" --> <div class="content"> - <!--#include virtual="includes/nav.html" --> + <!--#include virtual="includes/_nav.htm" --> <div class="right"> <h1>The committers</h1> <table style="margin-top: 4rem;"> @@ -163,4 +163,4 @@ $(function() { $('.b-nav__project').addClass('selected'); }); </script> -<!--#include virtual="includes/footer.html" --> +<!--#include virtual="includes/_footer.htm" --> http://git-wip-us.apache.org/repos/asf/kafka-site/blob/aa684e57/contact.html ---------------------------------------------------------------------- diff --git a/contact.html b/contact.html index c187937..94f0c3a 100644 --- a/contact.html +++ b/contact.html @@ -1,7 +1,7 @@ -<!--#include virtual="includes/header.html" --> -<!--#include virtual="includes/top.html" --> +<!--#include virtual="includes/_header.htm" --> +<!--#include virtual="includes/_top.htm" --> <div class="content"> - <!--#include virtual="includes/nav.html" --> + <!--#include virtual="includes/_nav.htm" --> <div class="right"> <h1>Contact</h1> <h3>Mailing Lists</h3> @@ -43,4 +43,4 @@ // Show selected style on nav item $(function() { $('.b-nav__contact').addClass('selected'); }); </script> -<!--#include virtual="includes/footer.html" --> +<!--#include virtual="includes/_footer.htm" --> http://git-wip-us.apache.org/repos/asf/kafka-site/blob/aa684e57/contributing.html ---------------------------------------------------------------------- diff --git a/contributing.html b/contributing.html index 82f492a..a77fca3 100644 --- a/contributing.html +++ b/contributing.html @@ -1,7 +1,7 @@ -<!--#include virtual="includes/header.html" --> -<!--#include virtual="includes/top.html" --> +<!--#include virtual="includes/_header.htm" --> +<!--#include virtual="includes/_top.htm" --> <div class="content"> - <!--#include virtual="includes/nav.html" --> + <!--#include virtual="includes/_nav.htm" --> <div class="right"> <h1>How to contribute</h1> <p>We are always very happy to have contributions, whether for trivial cleanups or big new features.</p> @@ -51,4 +51,4 @@ $(function() { $('.b-nav__project').addClass('selected'); }); </script> -<!--#include virtual="includes/footer.html" --> +<!--#include virtual="includes/_footer.htm" --> http://git-wip-us.apache.org/repos/asf/kafka-site/blob/aa684e57/documentation.html ---------------------------------------------------------------------- diff --git a/documentation.html b/documentation.html index 7812975..47fd10a 100644 --- a/documentation.html +++ b/documentation.html @@ -1,15 +1,2 @@ <!-- should always link the the latest release's documentation --> -<!--#include virtual="includes/header.html" --> -<!--#include virtual="includes/top.html" --> -<div class="content"> - <!--#include virtual="includes/nav.html" --> - <div class="right"> - <h1>Documentation</h1> - <!--#include virtual="0100/documentation.html" --> - -<!--#include virtual="includes/footer.html" --> - -<script> -// Show selected style on nav item -$(function() { $('.b-nav__docs').addClass('selected'); }); -</script> +<!--#include virtual="0100/documentation.html" --> http://git-wip-us.apache.org/repos/asf/kafka-site/blob/aa684e57/downloads.html ---------------------------------------------------------------------- diff --git a/downloads.html b/downloads.html index 979a124..b64b9ba 100644 --- a/downloads.html +++ b/downloads.html @@ -1,11 +1,9 @@ -<!--#include virtual="includes/header.html" --> -<!--#include virtual="includes/top.html" --> -<div class="sub-header"> - <h1>Download</h1> -</div> +<!--#include virtual="includes/_header.htm" --> +<!--#include virtual="includes/_top.htm" --> <div class="content"> - <!--#include virtual="includes/nav.html" --> + <!--#include virtual="includes/_nav.htm" --> <div class="right"> + <h1>Download</h1> <p>0.10.0.1 is the latest release. The current stable version is 0.10.0.1.</p> <p> @@ -289,4 +287,4 @@ You can download releases previous to 0.7.0-incubating <a href="http://sna-projects.com/kafka/downloads.php";>here</a>. </p> -<!--#include virtual="includes/footer.html" --> +<!--#include virtual="includes/_footer.htm" --> http://git-wip-us.apache.org/repos/asf/kafka-site/blob/aa684e57/images/logo.png ---------------------------------------------------------------------- diff --git a/images/logo.png b/images/logo.png index 0de768b..2b00298 100644 Binary files a/images/logo.png and b/images/logo.png differ http://git-wip-us.apache.org/repos/asf/kafka-site/blob/aa684e57/includes/_docs_banner.htm ---------------------------------------------------------------------- diff --git a/includes/_docs_banner.htm b/includes/_docs_banner.htm new file mode 100644 index 0000000..7ed9f0e --- /dev/null +++ b/includes/_docs_banner.htm @@ -0,0 +1,3 @@ +<a class="documentation__banner b-sticky-doc-banner" href="/documentation"> + You're viewing documentation for an older version of Kafka - check out our current documentation here. +</a> http://git-wip-us.apache.org/repos/asf/kafka-site/blob/aa684e57/includes/_docs_footer.htm ---------------------------------------------------------------------- diff --git a/includes/_docs_footer.htm b/includes/_docs_footer.htm new file mode 100644 index 0000000..f6cf782 --- /dev/null +++ b/includes/_docs_footer.htm @@ -0,0 +1,9 @@ +<script> +$(function() { + // Show selected style on nav item + $('.b-nav__docs').addClass('selected'); + + // Display docs subnav items + $('.b-nav__docs').parent().toggleClass('nav__item__with__subs--expanded'); +}); +</script> http://git-wip-us.apache.org/repos/asf/kafka-site/blob/aa684e57/includes/_footer.htm ---------------------------------------------------------------------- diff --git a/includes/_footer.htm b/includes/_footer.htm new file mode 100644 index 0000000..793ddb8 --- /dev/null +++ b/includes/_footer.htm @@ -0,0 +1,83 @@ + </div> + </div> + </div> + <div class="footer"> + <div class="footer__inner"> + <div class="footer__legal"> + <span>The contents of this website are © 2016 <a href="https://www.apache.org/"; target="_blank">Apache Software Foundation</a> under the terms of the <a href="https://www.apache.org/licenses/LICENSE-2.0.html"; target="_blank">Apache License v2</a>.</span> + <span>Apache Kafka and its logo are trademarks of the Apache Software Foundation.</span> + </div> + <a class="apache-feather" target="_blank" href="http://www.apache.org";> + <img width="40" src="/images/feather-small.png" alt="Apache Feather"> + </a> + </div> + </div> + </body> + + <script> + $(function() { + // Set mobile scroll position on nav + function setNavScroll(offsetLeft) { + $('.nav-scroller').animate({ + scrollLeft: $('.nav-scroller').scrollLeft() + $('nav .selected').offset().left - offsetLeft + }, 50); + } + + // Helper classes for nav + $('nav').mouseenter(function(){ + $(this).addClass('hovering'); + }); + $('nav').mouseleave(function(){ + $(this).removeClass('hovering'); + }); + + // Handle expanding sections of nav (async) + $('.b-nav__sub__anchor').click(function(){ + $('nav .selected').removeClass('selected'); + $('.nav__item__with__subs--expanded').removeClass('nav__item__with__subs--expanded'); + + $(this).addClass('selected'); + $(this).parent().toggleClass('nav__item__with__subs--expanded'); + + if($(window).width() <= 650) { + window.setTimeout(function(){ + setNavScroll(30); + }, 300); + } + }); + + // Initialize sticky elements on the page + if($(window).width() > 650) { + // Nav for desktop + $('.b-sticky-nav').stick_in_parent({offset_top: 40}); + // Documentation banner for desktop + $('.b-sticky-doc-banner').stick_in_parent({offset_top: 0}); + } else { + // Scroll nav for mobile so current nav item is in view + window.setTimeout(function(){ + setNavScroll(80); + }, 300); + } + + // On window resize check to see if stuff should be unstuck + window.onresize = function(event) { + if($(window).width() <= 650) { + $('.b-sticky-nav').trigger("sticky_kit:detach"); + } else { + $('.b-sticky-nav').stick_in_parent({offset_top: 40}); + $('.b-sticky-doc-banner').stick_in_parent({offset_top: 0}); + } + }; + }); + </script> + <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', 'UA-7818013-4', 'apache.org'); + ga('send', 'pageview'); + + </script> +</html> http://git-wip-us.apache.org/repos/asf/kafka-site/blob/aa684e57/includes/_header.htm ---------------------------------------------------------------------- diff --git a/includes/_header.htm b/includes/_header.htm new file mode 100644 index 0000000..db0e12e --- /dev/null +++ b/includes/_header.htm @@ -0,0 +1,21 @@ +<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN" "http://www.w3.org/TR/html4/strict.dtd";> +<html xmlns:og="http://ogp.me/ns#";> + <head> + <title>Apache Kafka</title> + <link rel='stylesheet' href='/styles.css' type='text/css'> + <link rel="icon" type="image/gif" href="/images/apache_feather.gif"> + <meta name="robots" content="index,follow" /> + <meta name="language" content="en" /> + <meta name="keywords" content="apache kafka messaging queuing distributed stream processing"> + <meta name="description" content="Apache Kafka: A Distributed Streaming Platform."> + <meta http-equiv='Content-Type' content='text/html;charset=utf-8' /> + <meta name="viewport" content="initial-scale = 1.0,maximum-scale = 1.0" /> + <meta property="og:title" value="Kafka" /> + <meta property="og:image" value="" /> + <meta property="og:description" value="Apache Kafka: A Distributed Streaming Platform." /> + <meta property="og:site_name" value="Apache Kafka" /> + <meta property="og:type" value="website" /> + <link href="https://fonts.googleapis.com/css?family=Cutive+Mono|Roboto:400,700,900" rel="stylesheet"> + <script src="/js/jquery.min.js"></script> + <script src="/js/jquery.sticky-kit.min.js"></script> + </head> http://git-wip-us.apache.org/repos/asf/kafka-site/blob/aa684e57/includes/_nav.htm ---------------------------------------------------------------------- diff --git a/includes/_nav.htm b/includes/_nav.htm new file mode 100644 index 0000000..08f8ab2 --- /dev/null +++ b/includes/_nav.htm @@ -0,0 +1,53 @@ +<nav class="b-sticky-nav"> + <div class="nav-scroller"> + <div class="nav__inner"> + <a class="b-nav__home nav__item" href="/">home</a> + <a class="b-nav__intro nav__item" href="/intro">introduction</a> + <a class="b-nav__quickstart nav__item" href="/quickstart">quickstart</a> + <a class="b-nav__uses nav__item" href="/uses">use cases</a> + <div class="nav__item nav__item__with__subs"> + <a class="b-nav__docs nav__item nav__sub__anchor" href="/documentation">documentation</a> + <a class="nav__item nav__sub__item" href="/documentation#gettingStarted">getting started</a> + <a class="nav__item nav__sub__item" href="/documentation#api">APIs</a> + <a class="nav__item nav__sub__item" href="/documentation#configuration">configuration</a> + <a class="nav__item nav__sub__item" href="/documentation#design">design</a> + <a class="nav__item nav__sub__item" href="/documentation#implementation">implementation</a> + <a class="nav__item nav__sub__item" href="/documentation#operations">operations</a> + <a class="nav__item nav__sub__item" href="/documentation#security">security</a> + <a class="nav__item nav__sub__item" href="/documentation#connect">kafka connect</a> + <a class="nav__item nav__sub__item" href="/documentation#streams">kafka streams</a> + </div> + <a class="b-nav__performance nav__item" href="/performance">performance</a> + <a class="b-nav__poweredby nav__item" target="_blank" href="https://cwiki.apache.org/confluence/display/KAFKA/Powered+By";>powered by</a> + <a class="b-nav__project nav__item" href="/project">project info</a> + <a class="b-nav__ecosystem nav__item" href="https://cwiki.apache.org/confluence/display/KAFKA/Ecosystem"; target="_blank">ecosystem</a> + <a class="b-nav__clients nav__item" href="https://cwiki.apache.org/confluence/display/KAFKA/Clients"; target="_blank">clients</a> + <a class="b-nav__contact nav__item" href="/contact">contact us</a> + <div class="nav__item nav__item__with__subs"> + <a class="b-nav__apache nav__item nav__sub__anchor b-nav__sub__anchor" href="#">apache</a> + <a class="b-nav__apache nav__item nav__sub__item" href="http://www.apache.org/"; target="_blank">foundation</a> + <a class="b-nav__apache nav__item nav__sub__item" href="http://www.apache.org/licenses/"; target="_blank">license</a> + <a class="b-nav__apache nav__item nav__sub__item" href="http://www.apache.org/foundation/sponsorship.html"; target="_blank">sponsorship</a> + <a class="b-nav__apache nav__item nav__sub__item" href="http://www.apache.org/foundation/thanks.html"; target="_blank">thanks</a> + <a class="b-nav__apache nav__item nav__sub__item" href="http://www.apache.org/security/"; target="_blank">security</a> + </div> + <a class="btn" href="/downloads">download</a> + <div class="social-links"> + <a class="twitter" href="https://twitter.com/apachekafka"; target="_blank">@apachekafka</a> + </div> + </div> + </div> + <div class="navindicator"> + <div class="b-nav__home navindicator__item"></div> + <div class="b-nav__intro navindicator__item"></div> + <div class="b-nav__quickstart navindicator__item"></div> + <div class="b-nav__uses navindicator__item"></div> + <div class="b-nav__docs navindicator__item"></div> + <div class="b-nav__performance navindicator__item"></div> + <div class="b-nav__poweredby navindicator__item"></div> + <div class="b-nav__project navindicator__item"></div> + <div class="b-nav__ecosystem navindicator__item"></div> + <div class="b-nav__clients navindicator__item"></div> + <div class="b-nav__contact navindicator__item"></div> + </div> +</nav> http://git-wip-us.apache.org/repos/asf/kafka-site/blob/aa684e57/includes/_top.htm ---------------------------------------------------------------------- diff --git a/includes/_top.htm b/includes/_top.htm new file mode 100644 index 0000000..a9cbc8d --- /dev/null +++ b/includes/_top.htm @@ -0,0 +1,5 @@ +<body> + <div class="main"> + <div class="header"> + <a href="/"><img width="325" height="97" class="logo" src="/images/logo.png"></a> + </div> http://git-wip-us.apache.org/repos/asf/kafka-site/blob/aa684e57/includes/footer.html ---------------------------------------------------------------------- diff --git a/includes/footer.html b/includes/footer.html deleted file mode 100644 index df3fbb6..0000000 --- a/includes/footer.html +++ /dev/null @@ -1,49 +0,0 @@ - </div> - </div> - </div> - <div class="footer"> - <div class="footer__inner"> - <span class="footer__legal">Apache Kafka, Kafka, Apache, and the Kafka logo are trademarks of The Apache Software Foundation.</span> - <a class="apache-feather" target="_blank" href="http://www.apache.org";> - <img width="40" src="/images/feather-small.png" alt="Apache Feather"> - </a> - </div> - </div> - </body> - - <script> - $(function() { - // Helper classes for nav - $('nav').mouseenter(function(){ - $(this).addClass('hovering'); - }); - $('nav').mouseleave(function(){ - $(this).removeClass('hovering'); - }); - - // Initialize sticky elements on the page - if($(window).width() > 650) { - $('.b-sticky-nav').stick_in_parent({offset_top: 40}); - } - - // On window resize check to see if stuff should be unstuck - window.onresize = function(event) { - if($(window).width() <= 650) { - $('.b-sticky-nav').trigger("sticky_kit:detach") - } else { - $('.b-sticky-nav').stick_in_parent({offset_top: 40}); - } - }; - }); - </script> - <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', 'UA-7818013-4', 'apache.org'); - ga('send', 'pageview'); - - </script> -</html> http://git-wip-us.apache.org/repos/asf/kafka-site/blob/aa684e57/includes/header.html ---------------------------------------------------------------------- diff --git a/includes/header.html b/includes/header.html deleted file mode 100644 index db0e12e..0000000 --- a/includes/header.html +++ /dev/null @@ -1,21 +0,0 @@ -<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN" "http://www.w3.org/TR/html4/strict.dtd";> -<html xmlns:og="http://ogp.me/ns#";> - <head> - <title>Apache Kafka</title> - <link rel='stylesheet' href='/styles.css' type='text/css'> - <link rel="icon" type="image/gif" href="/images/apache_feather.gif"> - <meta name="robots" content="index,follow" /> - <meta name="language" content="en" /> - <meta name="keywords" content="apache kafka messaging queuing distributed stream processing"> - <meta name="description" content="Apache Kafka: A Distributed Streaming Platform."> - <meta http-equiv='Content-Type' content='text/html;charset=utf-8' /> - <meta name="viewport" content="initial-scale = 1.0,maximum-scale = 1.0" /> - <meta property="og:title" value="Kafka" /> - <meta property="og:image" value="" /> - <meta property="og:description" value="Apache Kafka: A Distributed Streaming Platform." /> - <meta property="og:site_name" value="Apache Kafka" /> - <meta property="og:type" value="website" /> - <link href="https://fonts.googleapis.com/css?family=Cutive+Mono|Roboto:400,700,900" rel="stylesheet"> - <script src="/js/jquery.min.js"></script> - <script src="/js/jquery.sticky-kit.min.js"></script> - </head> http://git-wip-us.apache.org/repos/asf/kafka-site/blob/aa684e57/includes/nav.html ---------------------------------------------------------------------- diff --git a/includes/nav.html b/includes/nav.html deleted file mode 100644 index 0e31310..0000000 --- a/includes/nav.html +++ /dev/null @@ -1,34 +0,0 @@ -<nav class="b-sticky-nav"> - <div class="nav-scroller"> - <div class="nav__inner"> - <a class="b-nav__home nav__item" href="/">home</a> - <a class="b-nav__intro nav__item" href="/intro.html">introduction</a> - <a class="b-nav__quickstart nav__item" href="/quickstart.html">quickstart</a> - <a class="b-nav__uses nav__item" href="/uses.html">use cases</a> - <a class="b-nav__docs nav__item" href="/documentation.html">documentation</a> - <a class="b-nav__performance nav__item" href="/performance.html">performance</a> - <a class="b-nav__poweredby nav__item" target="_blank" href="https://cwiki.apache.org/confluence/display/KAFKA/Powered+By";>powered by</a> - <a class="b-nav__project nav__item" href="/project.html">project info</a> - <a class="b-nav__ecosystem nav__item" href="https://cwiki.apache.org/confluence/display/KAFKA/Ecosystem"; target="_blank">ecosystem</a> - <a class="b-nav__clients nav__item" href="https://cwiki.apache.org/confluence/display/KAFKA/Clients"; target="_blank">clients</a> - <a class="b-nav__contact nav__item" href="/contact.html">contact</a> - <a class="btn" href="/downloads.html">download</a> - <div class="social-links"> - <a class="twitter" href="https://twitter.com/apachekafka"; target="_blank">@apachekafka</a> - </div> - </div> - </div> - <div class="navindicator"> - <div class="b-nav__home navindicator__item"></div> - <div class="b-nav__intro navindicator__item"></div> - <div class="b-nav__quickstart navindicator__item"></div> - <div class="b-nav__uses navindicator__item"></div> - <div class="b-nav__docs navindicator__item"></div> - <div class="b-nav__performance navindicator__item"></div> - <div class="b-nav__poweredby navindicator__item"></div> - <div class="b-nav__project navindicator__item"></div> - <div class="b-nav__ecosystem navindicator__item"></div> - <div class="b-nav__clients navindicator__item"></div> - <div class="b-nav__contact navindicator__item"></div> - </div> -</nav> http://git-wip-us.apache.org/repos/asf/kafka-site/blob/aa684e57/includes/top.html ---------------------------------------------------------------------- diff --git a/includes/top.html b/includes/top.html deleted file mode 100644 index a9cbc8d..0000000 --- a/includes/top.html +++ /dev/null @@ -1,5 +0,0 @@ -<body> - <div class="main"> - <div class="header"> - <a href="/"><img width="325" height="97" class="logo" src="/images/logo.png"></a> - </div> http://git-wip-us.apache.org/repos/asf/kafka-site/blob/aa684e57/index.html ---------------------------------------------------------------------- diff --git a/index.html b/index.html index 66989dc..05fd198 100644 --- a/index.html +++ b/index.html @@ -1,7 +1,7 @@ -<!--#include virtual="includes/header.html" --> -<!--#include virtual="includes/top.html" --> +<!--#include virtual="includes/_header.htm" --> +<!--#include virtual="includes/_top.htm" --> <div class="content"> - <!--#include virtual="includes/nav.html" --> + <!--#include virtual="includes/_nav.htm" --> <div class="right"> <div class="desc"> <div class="desc-item"> @@ -30,4 +30,4 @@ $(function() { $('.b-nav__home').addClass('selected'); }); </script> -<!--#include virtual="includes/footer.html" --> +<!--#include virtual="includes/_footer.htm" --> http://git-wip-us.apache.org/repos/asf/kafka-site/blob/aa684e57/intro.html ---------------------------------------------------------------------- diff --git a/intro.html b/intro.html index 51dc268..c2ccfa0 100644 --- a/intro.html +++ b/intro.html @@ -1,12 +1,12 @@ -<!--#include virtual="includes/header.html" --> -<!--#include virtual="includes/top.html" --> +<!--#include virtual="includes/_header.htm" --> +<!--#include virtual="includes/_top.htm" --> <div class="content"> - <!--#include virtual="includes/nav.html" --> + <!--#include virtual="includes/_nav.htm" --> <div class="right"> <h1>Introduction</h1> <!--#include virtual="0100/introduction.html" --> -<!--#include virtual="includes/footer.html" --> +<!--#include virtual="includes/_footer.htm" --> <script> // Show selected style on nav item http://git-wip-us.apache.org/repos/asf/kafka-site/blob/aa684e57/performance.html ---------------------------------------------------------------------- diff --git a/performance.html b/performance.html index ed6ab45..d060936 100644 --- a/performance.html +++ b/performance.html @@ -1,13 +1,13 @@ -<!--#include virtual="includes/header.html" --> -<!--#include virtual="includes/top.html" --> +<!--#include virtual="includes/_header.htm" --> +<!--#include virtual="includes/_top.htm" --> <div class="content"> - <!--#include virtual="includes/nav.html" --> + <!--#include virtual="includes/_nav.htm" --> <div class="right"> <h1>Performance</h1> <p>A brief overview of the performance characteristics of Kafka.</p> <a href="http://engineering.linkedin.com/kafka/benchmarking-apache-kafka-2-million-writes-second-three-cheap-machines";>Read blog post</a> -<!--#include virtual="includes/footer.html" --> +<!--#include virtual="includes/_footer.htm" --> <script> // Show selected style on nav item http://git-wip-us.apache.org/repos/asf/kafka-site/blob/aa684e57/project-security.html ---------------------------------------------------------------------- diff --git a/project-security.html b/project-security.html index 58b639a..85a6eb5 100644 --- a/project-security.html +++ b/project-security.html @@ -15,10 +15,10 @@ limitations under the License. --> -<!--#include virtual="includes/header.html" --> -<!--#include virtual="includes/top.html" --> +<!--#include virtual="includes/_header.htm" --> +<!--#include virtual="includes/_top.htm" --> <div class="content"> - <!--#include virtual="includes/nav.html" --> + <!--#include virtual="includes/_nav.htm" --> <div class="right"> <h1>Kafka security</h1> <p> @@ -31,7 +31,7 @@ The <span class="caps">ASF</span> Security team maintains a page with a description of how vulnerabilities are handled, check their <a href="http://www.apache.org/security/";>Web page</a> for more information. </p> -<!--#include virtual="includes/footer.html" --> +<!--#include virtual="includes/_footer.htm" --> <script> // Show selected style on nav item http://git-wip-us.apache.org/repos/asf/kafka-site/blob/aa684e57/project.html ---------------------------------------------------------------------- diff --git a/project.html b/project.html index 960a6e5..82c41db 100644 --- a/project.html +++ b/project.html @@ -15,10 +15,10 @@ limitations under the License. --> -<!--#include virtual="includes/header.html" --> -<!--#include virtual="includes/top.html" --> +<!--#include virtual="includes/_header.htm" --> +<!--#include virtual="includes/_top.htm" --> <div class="content"> - <!--#include virtual="includes/nav.html" --> + <!--#include virtual="includes/_nav.htm" --> <div class="right"> <h1>Project information</h1> <h3 class="bullet">Wiki</h3> @@ -26,27 +26,27 @@ <h3 class="bullet">Bugs</h3> <a class="pb-10" href="https://issues.apache.org/jira/browse/KAFKA"; target="_blank">Follow current development and issues</a> <h3 class="bullet">Committers</h3> - <a class="pb-10" href="/committers.html">See the project committers</a> + <a class="pb-10" href="/committers">See the project committers</a> <h3 class="bullet">Security</h3> - <a class="pb-10" href="/project-security.html">Learn about Kafka security</a> + <a class="pb-10" href="/project-security">Learn about Kafka security</a> <h3 class="bullet">Papers & talks</h3> <a class="pb-10" href="https://cwiki.apache.org/confluence/display/KAFKA/Kafka+papers+and+presentations"; target="_blank">View our papers and talks</a> <h3 class="bullet">Developer info</h3> <ul> <li> - <a href="/code.html">Getting the code</a> + <a href="/code">Getting the code</a> </li> <li> <a href="http://cwiki.apache.org/confluence/display/KAFKA/Projects"; target="_blank">Projects</a> </li> <li> - <a href="/contributing.html">How to contribute</a> + <a href="/contributing">How to contribute</a> </li> <li> - <a href="/coding-guide.html">Code guidelines</a> + <a href="/coding-guide">Code guidelines</a> </li> <li> - <a href="/protocol.html">Protocol guide</a> + <a href="/protocol">Protocol guide</a> </li> <li> <a href="https://builds.apache.org/"; target="_blank">Unit tests</a> @@ -55,7 +55,7 @@ <h3 class="bullet">Twitter</h3> <a href="https://twitter.com/apachekafka"; target="_blank">@apachekafka</a> -<!--#include virtual="includes/footer.html" --> +<!--#include virtual="includes/_footer.htm" --> <script> // Show selected style on nav item http://git-wip-us.apache.org/repos/asf/kafka-site/blob/aa684e57/quickstart.html ---------------------------------------------------------------------- diff --git a/quickstart.html b/quickstart.html index 49f3f2d..68e6cfa 100644 --- a/quickstart.html +++ b/quickstart.html @@ -1,13 +1,11 @@ -<!--#include virtual="includes/header.html" --> -<!--#include virtual="includes/top.html" --> +<!--#include virtual="includes/_header.htm" --> +<!--#include virtual="includes/_top.htm" --> <div class="content"> - <!--#include virtual="includes/nav.html" --> + <!--#include virtual="includes/_nav.htm" --> <div class="right"> - <h1>Quickstart</h1> -<!--#include virtual="0100/quickstart.html" --> - -<!--#include virtual="includes/footer.html" --> - + <h1>Quickstart</h1> + <!--#include virtual="0100/quickstart.html" --> +<!--#include virtual="includes/_footer.htm" --> <script> // Show selected style on nav item $(function() { $('.b-nav__quickstart').addClass('selected'); }); http://git-wip-us.apache.org/repos/asf/kafka-site/blob/aa684e57/styles.css ---------------------------------------------------------------------- diff --git a/styles.css b/styles.css index 339fb56..580f79c 100644 --- a/styles.css +++ b/styles.css @@ -197,6 +197,9 @@ ul { .footer__legal { margin: 0 2rem; } +.footer__legal a { + color: #666666; +} .sub-header { overflow: hidden; margin: 3rem 0 1rem; @@ -209,16 +212,36 @@ nav { text-transform: uppercase; width: 16rem; } -.nav__item { +.nav__item, +.nav__item__with__subs { color: #000000; border-right: 2px solid #000000; display: block; padding-top: 1.5rem; position: relative; } +.nav__item__with__subs { + padding-top: 0; +} +.nav__sub__anchor, +.nav__sub__item { + border-right: none; +} +.nav__sub__item { + display: none; + color: #888888; + font-size: 1.2rem; + text-transform: capitalize; +} +.nav__item__with__subs--expanded .nav__sub__item { + display: block; +} .nav__item:first-of-type { padding-top: 0; } +.nav__item__with__subs .nav__item:first-of-type { + padding-top: 1.5rem; +} .nav__item::after { content: ""; display: block; @@ -241,6 +264,9 @@ nav { .nav__item.selected:first-of-type::after { top: .2rem; } +.nav__item__with__subs .nav__item:first-of-type::after { + top: 1.7rem; +} nav .btn { display: block; margin-top: 4rem; @@ -270,13 +296,48 @@ nav .btn { position: absolute; bottom: 2rem; right: 2rem; - transition: all .2s ease-out; } .apache-feather:hover { - -ms-transform: rotate(-56deg); - -webkit-transform: rotate(-56deg); - transform: rotate(-56deg); + -webkit-animation-name: spin; + -webkit-animation-duration: 200ms; + -webkit-animation-iteration-count: infinite; + -webkit-animation-timing-function: linear; + -moz-animation-name: spin; + -moz-animation-duration: 200ms; + -moz-animation-iteration-count: infinite; + -moz-animation-timing-function: linear; + -ms-animation-name: spin; + -ms-animation-duration: 200ms; + -ms-animation-iteration-count: infinite; + -ms-animation-timing-function: linear; + + animation-name: spin; + animation-duration: 200ms; + animation-iteration-count: infinite; + animation-timing-function: linear; +} + + +@-ms-keyframes spin { + from { -ms-transform: rotate(0deg); } + to { -ms-transform: rotate(360deg); } +} +@-moz-keyframes spin { + from { -moz-transform: rotate(0deg); } + to { -moz-transform: rotate(360deg); } +} +@-webkit-keyframes spin { + from { -webkit-transform: rotate(0deg); } + to { -webkit-transform: rotate(360deg); } +} +@keyframes spin { + from { + transform:rotate(0deg); + } + to { + transform:rotate(360deg); + } } /* pages */ @@ -337,6 +398,24 @@ nav .btn { width: 10rem; } +.documentation__banner { + background-color: rgba(0,0,0,0.8); + color: #ffffff; + display: block; + padding: 1.5rem 2rem; + margin-bottom: 3rem +} + +.documentation__banner:hover { + background-color: #888888; + color: #ffffff; + cursor: pointer; +} + +.documentation--current .documentation__banner { + display: none; +} + /* Responsive styles */ @media only screen and (max-width: 1240px) { .main { @@ -368,6 +447,12 @@ nav .btn { .callout { margin: 2rem 1.5rem; } + .apache-feather { + bottom: 2.8rem; + } + .footer__legal span { + display:block; + } } @media only screen and (max-width: 800px) { @@ -390,6 +475,14 @@ nav .btn { } @media only screen and (max-width: 650px) { + html, body { + overflow-y: auto; + -webkit-overflow-scrolling: touch; + } + .main { + padding: 0 1rem; + margin: 0; + } .kafka-diagram { display: block; margin: 0 auto; @@ -397,6 +490,9 @@ nav .btn { .callout { margin: 2rem auto; } + .right { + padding-bottom: 10rem; + } .navindicator { min-width: 32rem; position: absolute; @@ -426,17 +522,20 @@ nav .btn { width: 100%; } .nav-scroller { + white-space: nowrap; + overflow-y: hidden; overflow-x: scroll; + -webkit-overflow-scrolling: touch; box-shadow: 0 0 1rem rgba(0,0,0,0.3); } .nav__inner { - width: 1500px; + width: 2000px; } .nav__item, .nav__item:first-of-type { color: #888888; float: left; - padding: 2.2rem 1.6rem 1.1rem; + padding: 2.6rem 1.1rem 1.8rem; border: none; } .nav__item.selected, @@ -451,6 +550,14 @@ nav .btn { .footer { display: none; } + .nav__item__with__subs .nav__item:first-of-type, + .nav__item .nav__item { + padding: 0; + } + .nav__sub__item { + margin-left: 2rem; + line-height: 2.2rem; + } .right { margin: 0; min-height: auto; @@ -468,7 +575,7 @@ nav .btn { font-size: 1.6rem; } .logo { - width: 23rem; + width: 21.667rem; height: auto; } .desc-item, http://git-wip-us.apache.org/repos/asf/kafka-site/blob/aa684e57/uses.html ---------------------------------------------------------------------- diff --git a/uses.html b/uses.html index ceed247..943d565 100644 --- a/uses.html +++ b/uses.html @@ -1,13 +1,13 @@ -<!--#include virtual="includes/header.html" --> -<!--#include virtual="includes/top.html" --> +<!--#include virtual="includes/_header.htm" --> +<!--#include virtual="includes/_top.htm" --> <div class="content"> - <!--#include virtual="includes/nav.html" --> + <!--#include virtual="includes/_nav.htm" --> <div class="right"> <h1>Use cases</h1> <!--#include virtual="0100/uses.html" --> -<!--#include virtual="includes/footer.html" --> +<!--#include virtual="includes/_footer.htm" --> <script> // Show selected style on nav item
