From 0949c210b08f0587cb4d244e97495ce37cc76550 Mon Sep 17 00:00:00 2001 From: Sven Petersen Date: Wed, 1 Jun 2022 14:21:14 +0200 Subject: [PATCH 1/9] version dropdown --- src/css/nav.css | 16 ++++++++++++++++ src/partials/nav-menu.hbs | 22 ++++++++++++++++++---- 2 files changed, 34 insertions(+), 4 deletions(-) diff --git a/src/css/nav.css b/src/css/nav.css index 2c5bcab..5bc8f75 100644 --- a/src/css/nav.css +++ b/src/css/nav.css @@ -256,3 +256,19 @@ html.is-clipped--nav { opacity: 0.9; font-weight: var(--body-font-weight-bold); } + +.nav-menu .title-wrapper { + display: flex; +} + +.nav-menu .title-wrapper h3 { + flex-grow: 2; +} + +.nav-menu .title-wrapper .page-versions { + flex-grow: 1; + min-width: 85px; + margin-right: 0; + margin-left: 5px; + text-align: end; +} diff --git a/src/partials/nav-menu.hbs b/src/partials/nav-menu.hbs index 46adf92..b77ee40 100644 --- a/src/partials/nav-menu.hbs +++ b/src/partials/nav-menu.hbs @@ -1,10 +1,24 @@ {{#with page.navigation}} {{/with}} From cb6200d5571b956ca6333982950a42357e091df8 Mon Sep 17 00:00:00 2001 From: Sven Petersen Date: Mon, 20 Jun 2022 22:47:59 +0200 Subject: [PATCH 2/9] fix: issue #212 - problem with mobile navbar / burger menu --- src/css/search.css | 9 ++++++++- src/partials/header-content.hbs | 2 +- 2 files changed, 9 insertions(+), 2 deletions(-) diff --git a/src/css/search.css b/src/css/search.css index 1861408..b59b8cc 100644 --- a/src/css/search.css +++ b/src/css/search.css @@ -14,7 +14,7 @@ background-color: #474d57; font-family: inherit; font-size: 0.95rem; - width: 150px; + width: 120px; border: none; line-height: 1.5; padding: 4px 20px; @@ -29,12 +29,19 @@ outline: none; } +@media screen and (min-width: 500px) { + #search-input { + width: 150px; + } +} + @media screen and (min-width: 769px) { #search-input { width: 200px; } } + .search-result-dropdown-menu { position: absolute; z-index: 100; diff --git a/src/partials/header-content.hbs b/src/partials/header-content.hbs index 136e9af..e6d4e51 100644 --- a/src/partials/header-content.hbs +++ b/src/partials/header-content.hbs @@ -7,7 +7,7 @@ {{#if env.SITE_SEARCH_PROVIDER}} {{/if}} From 01cb1ce218c34182ba108129640fb798d29d62a5 Mon Sep 17 00:00:00 2001 From: Felix Hennig Date: Tue, 21 Jun 2022 17:11:21 +0200 Subject: [PATCH 3/9] Fixed linting issue (2 blank lines) --- src/css/search.css | 1 - 1 file changed, 1 deletion(-) diff --git a/src/css/search.css b/src/css/search.css index b59b8cc..29e853e 100644 --- a/src/css/search.css +++ b/src/css/search.css @@ -41,7 +41,6 @@ } } - .search-result-dropdown-menu { position: absolute; z-index: 100; From 046c3db88378337ef95b002670dffc11883d6cdb Mon Sep 17 00:00:00 2001 From: Felix Hennig Date: Tue, 21 Jun 2022 17:22:15 +0200 Subject: [PATCH 4/9] removed version toggle from old location --- src/partials/toolbar.hbs | 1 - 1 file changed, 1 deletion(-) diff --git a/src/partials/toolbar.hbs b/src/partials/toolbar.hbs index c6e9ea6..3e9e66c 100644 --- a/src/partials/toolbar.hbs +++ b/src/partials/toolbar.hbs @@ -4,7 +4,6 @@ {{/with}} {{> breadcrumbs}} -{{> page-versions}} {{#if (and page.fileUri (not env.CI))}} {{else if (and page.editUrl (or env.FORCE_SHOW_EDIT_PAGE_LINK (not page.origin.private)))}} From 75cc1a7e005d06243e5806c83a34d9f9238d0b3d Mon Sep 17 00:00:00 2001 From: Sven Petersen Date: Thu, 23 Jun 2022 18:43:44 +0200 Subject: [PATCH 5/9] fix: issue #212 - problem width page width on mobile devices --- preview-src/index.adoc | 141 +++++++++++++++++++++++++++++++---------- src/css/base.css | 18 ++++-- src/css/landing.css | 55 ++++++++-------- 3 files changed, 145 insertions(+), 69 deletions(-) diff --git a/preview-src/index.adoc b/preview-src/index.adoc index 2631013..c7f277a 100644 --- a/preview-src/index.adoc +++ b/preview-src/index.adoc @@ -1,14 +1,8 @@ = Stackable Documentation -Author Name -#:page-layout: landing -:idprefix: -:idseparator: - -:!example-caption: -:!table-caption: -:page-pagination: +:page-layout: landing Welcome to Stackable! -This documentation gives you an overview of our platform, how to install and manage it as well as some tutorials. +This documentation gives you an overview of the Stackable Data Platform, how to install and manage it as well as some tutorials. ++++
@@ -26,14 +20,11 @@ This documentation gives you an overview of our platform, how to install and man

Introduction

++++ -If you have any feedback regarding the documentation please either open an https://github.com/stackabletech/documentation/issues[issue], ask a https://github.com/stackabletech/documentation/discussions[question] or look at the source for this documentation in its https://github.com/stackabletech/documentation[repository]. - -Our Stackable platform allows you to deploy, scale and manage Big Data infrastructure in any environment as long as it can run https://kubernetes.io/[Kubernetes]. +The Stackable Data Platform allows you to deploy, scale and manage Data infrastructure in any environment running https://kubernetes.io/[Kubernetes]. +You can find an overview of the supported components <>, as we as a full list of all supported product versions xref:operators:supported_versions.adoc[here]. -IMPORTANT: Our platform used to be based on a different architecture (until November 2021) where we built an alternative Kubelet. We abandoned that effort for now and are moving towards a Kubernetes-native experience using the normal `kubelet`. -This is an ongoing effort and the documentation might not reflect reality everywhere. -We aim to update our platform as well as the documentation by the end of 2021 and will remove this note when the migration has completed. +If you have any feedback regarding the documentation please either open an https://github.com/stackabletech/documentation/issues[issue], ask a https://github.com/stackabletech/documentation/discussions[question] or look at the source for this documentation in its https://github.com/stackabletech/documentation[repository]. ++++ @@ -54,7 +45,7 @@ While the platform got started in the _Big Data_ ecosystem we are in no way limi You can declaratively build these environments, and we don't stop at the tool level as we also provide ways for the users to interact with the platform in the "as Code"-approach. -We are leveraging the https://www.openpolicyagent.org/[OpenPolicyAgent] to provide Authorization-as-Code. +We are leveraging the https://www.openpolicyagent.org/[Open Policy Agent] to provide Security-as-Code. We are building a distribution that includes the “best of breed” of existing Open Source tools, but bundles them in a way, so it is easy to deploy a fully working stack of software. Most of the existing tools are “single purpose” tools, which often do not play nicely together out-of-the-box. @@ -70,7 +61,8 @@ We are building a distribution that includes the “best of breed” of existing We are using Kubernetes as our deployment platform. And we're building https://kubernetes.io/docs/concepts/extend-kubernetes/operator/[Operators] for each of the products we support. -At the moment we support the following products (i.e. we have operators for each of those): + +The Stackable Data Platform supports the following products: ++++
@@ -85,12 +77,60 @@ At the moment we support the following products (i.e. we have operators for each ++++ ++++ -

Kafka Operator

+

Apache Airflow

+++++ + +Airflow is a workflow engine and your replacement should you be using Apache Oozie. + +xref:airflow::index.adoc[Read more] + +++++ + +++++ + +++++ +
+++++ + +++++ +

Apache Druid

+++++ + +Apache Druid is a real-time database to power modern analytics applications. + +xref:druid::index.adoc[Read more] + +++++ +
+++++ + +++++ +
+++++ + +++++ +

Apache HBase

+++++ + +HBase is a distributed, scalable, big data store. + +xref:hbase::index.adoc[Read more] + +++++ +
+++++ + +++++ +
+++++ + +++++ +

Apache Hadoop HDFS

++++ -Lorem ipsum dolor sit amet, consetetur sadipscing elitr, sed diam nonumy eirmod tempor invidunt ut labore et dolore magna aliquyam erat, sed diam voluptua. At vero eos et accusam et justo duo dolores et ea rebum. Stet clita kasd gubergren, no sea takimata sanctus est Lorem ipsum dolor sit amet. +HDFS is a distributed file system that provides high-throughput access to application data. -link:/kafka/index.html[Read more] +xref:hdfs::index.adoc[Read more] ++++
@@ -101,12 +141,12 @@ link:/kafka/index.html[Read more] ++++ ++++ -

Spark Operator

+

Apache Hive

++++ -Lorem ipsum dolor sit amet, consetetur sadipscing elitr, sed diam nonumy eirmod tempor invidunt ut labore et dolore magna aliquyam erat, sed diam voluptua. At vero eos et accusam et justo duo dolores et ea rebum. Stet clita kasd gubergren, no sea takimata sanctus est Lorem ipsum dolor sit amet. +The Apache Hive data warehouse software facilitates reading, writing, and managing large datasets residing in distributed storage using SQL. We support the Hive Metastore. -link:/spark/index.html[Read more] +xref:hive::index.adoc[Read more] ++++ @@ -117,12 +157,12 @@ link:/spark/index.html[Read more] ++++ ++++ -

Trino Operator

+

Apache Kafka

++++ -Lorem ipsum dolor sit amet, consetetur sadipscing elitr, sed diam nonumy eirmod tempor invidunt ut labore et dolore magna aliquyam erat, sed diam voluptua. At vero eos et accusam et justo duo dolores et ea rebum. Stet clita kasd gubergren, no sea takimata sanctus est Lorem ipsum dolor sit amet. +Apache Kafka is an open-source distributed event streaming platform used by thousands of companies for high-performance data pipelines, streaming analytics, data integration, and mission-critical applications. -link:/trino/index.html[Read more] +xref:kafka::index.adoc[Read more] ++++ @@ -133,12 +173,12 @@ link:/trino/index.html[Read more] ++++ ++++ -

Zookeeper Operator

+

Apache NiFi

++++ -Lorem ipsum dolor sit amet, consetetur sadipscing elitr, sed diam nonumy eirmod tempor invidunt ut labore et dolore magna aliquyam erat, sed diam voluptua. At vero eos et accusam et justo duo dolores et ea rebum. Stet clita kasd gubergren, no sea takimata sanctus est Lorem ipsum dolor sit amet. +An easy to use, powerful, and reliable system to process and distribute data. -link:/zookeeper/index.html[Read more] +xref:nifi::index.adoc[Read more] ++++ @@ -149,12 +189,12 @@ link:/zookeeper/index.html[Read more] ++++ ++++ -

NiFi Operator

+

Apache Spark

++++ -Lorem ipsum dolor sit amet, consetetur sadipscing elitr, sed diam nonumy eirmod tempor invidunt ut labore et dolore magna aliquyam erat, sed diam voluptua. At vero eos et accusam et justo duo dolores et ea rebum. Stet clita kasd gubergren, no sea takimata sanctus est Lorem ipsum dolor sit amet. +Apache Spark is a multi-language engine for executing data engineering, data science, and machine learning on single-node machines or clusters. -link:/nifi/index.html[Read more] +xref:spark-k8s::index.adoc[Read more] ++++ @@ -165,17 +205,50 @@ link:/nifi/index.html[Read more] ++++ ++++ -

Superset Operator

+

Apache Superset

++++ -Lorem ipsum dolor sit amet, consetetur sadipscing elitr, sed diam nonumy eirmod tempor invidunt ut labore et dolore magna aliquyam erat, sed diam voluptua. At vero eos et accusam et justo duo dolores et ea rebum. Stet clita kasd gubergren, no sea takimata sanctus est Lorem ipsum dolor sit amet. +Apache Superset is a modern data exploration and visualization platform. -link:/superset/index.html[Read more] +xref:superset::index.adoc[Read more] ++++ ++++ +++++ +
+++++ + +++++ +

Trino

+++++ + +Fast distributed SQL query engine for big data analytics that helps you explore your data universe. + +xref:trino::index.adoc[Read more] + +++++ +
+++++ + +++++ +
+++++ + +++++ +

Apache ZooKeeper

+++++ + +ZooKeeper is a centralized service for maintaining configuration information, naming, providing distributed synchronization, and providing group services. + +xref:zookeeper::index.adoc[Read more] + +++++ +
+++++ + + ++++ ++++ diff --git a/src/css/base.css b/src/css/base.css index e4823bf..ef17c15 100644 --- a/src/css/base.css +++ b/src/css/base.css @@ -118,10 +118,16 @@ body ::-webkit-scrollbar-thumb { background-color: var(--scrollbar-thumb-color); } -.container { - display: flex; - position: relative; - width: 100%; - max-width: 1280px; - margin: 0 auto; +@media screen and (min-width: 1024px) { + .container { + display: flex; + position: relative; + width: 100%; + max-width: 1280px; + margin: 0 auto; + } } + + + + diff --git a/src/css/landing.css b/src/css/landing.css index 9c56913..c78e620 100644 --- a/src/css/landing.css +++ b/src/css/landing.css @@ -1,33 +1,35 @@ -.boxes { - display: flex; - flex-wrap: wrap; - justify-content: space-between; -} +@media screen and (min-width: 768px) { + .boxes { + display: flex; + flex-wrap: wrap; + justify-content: space-between; + } -.box { - flex: 0 30%; - min-height: 200px; - margin-bottom: 2%; /* (200-32*3)/2 */ -} + .box { + flex: 0 30%; + min-height: 200px; + margin-bottom: 2%; /* (200-32*3)/2 */ + } -.boxes.two-column .box { - flex: 0 48%; -} + .boxes.two-column .box { + flex: 0 48%; + } -.box h3 { - display: inline-block; -} + .box h3 { + display: inline-block; + } -.box div { - display: inline-block; -} + .box div { + display: inline-block; + } -.box p { - display: inline-block; -} + .box p { + display: inline-block; + } -.box .admonitionblock { - margin-top: 2.8rem; + .box .admonitionblock { + margin-top: 2.8rem; + } } @media screen and (max-width: 1023.5px) { @@ -36,8 +38,3 @@ } } -@media screen and (max-width: 768px) { - .box { - flex: 0 100% !important; - } -} From ea935e917e067d09595c484e550fc5eb64bd760f Mon Sep 17 00:00:00 2001 From: Felix Hennig Date: Mon, 27 Jun 2022 09:38:28 +0200 Subject: [PATCH 6/9] removed excess empty lines --- src/css/base.css | 4 ---- src/css/landing.css | 1 - 2 files changed, 5 deletions(-) diff --git a/src/css/base.css b/src/css/base.css index ef17c15..aa0a433 100644 --- a/src/css/base.css +++ b/src/css/base.css @@ -127,7 +127,3 @@ body ::-webkit-scrollbar-thumb { margin: 0 auto; } } - - - - diff --git a/src/css/landing.css b/src/css/landing.css index c78e620..d2028cd 100644 --- a/src/css/landing.css +++ b/src/css/landing.css @@ -37,4 +37,3 @@ flex: 0 47% !important; } } - From 7f90fb94d5a920db6fec1f97dee8cc9b9fd51f96 Mon Sep 17 00:00:00 2001 From: Siegfried Weber Date: Mon, 4 Jul 2022 11:40:40 +0200 Subject: [PATCH 7/9] Revert "fix: issue #212 - problem width page width on mobile devices" because it breaks all other usages of the container class, e.g. the navigation bar. Instead, prevent the browser from calculating the minimum width. --- src/css/base.css | 14 +++++------- src/css/landing.css | 56 ++++++++++++++++++++++++--------------------- src/css/main.css | 5 +++- 3 files changed, 40 insertions(+), 35 deletions(-) diff --git a/src/css/base.css b/src/css/base.css index aa0a433..e4823bf 100644 --- a/src/css/base.css +++ b/src/css/base.css @@ -118,12 +118,10 @@ body ::-webkit-scrollbar-thumb { background-color: var(--scrollbar-thumb-color); } -@media screen and (min-width: 1024px) { - .container { - display: flex; - position: relative; - width: 100%; - max-width: 1280px; - margin: 0 auto; - } +.container { + display: flex; + position: relative; + width: 100%; + max-width: 1280px; + margin: 0 auto; } diff --git a/src/css/landing.css b/src/css/landing.css index d2028cd..9c56913 100644 --- a/src/css/landing.css +++ b/src/css/landing.css @@ -1,35 +1,33 @@ -@media screen and (min-width: 768px) { - .boxes { - display: flex; - flex-wrap: wrap; - justify-content: space-between; - } +.boxes { + display: flex; + flex-wrap: wrap; + justify-content: space-between; +} - .box { - flex: 0 30%; - min-height: 200px; - margin-bottom: 2%; /* (200-32*3)/2 */ - } +.box { + flex: 0 30%; + min-height: 200px; + margin-bottom: 2%; /* (200-32*3)/2 */ +} - .boxes.two-column .box { - flex: 0 48%; - } +.boxes.two-column .box { + flex: 0 48%; +} - .box h3 { - display: inline-block; - } +.box h3 { + display: inline-block; +} - .box div { - display: inline-block; - } +.box div { + display: inline-block; +} - .box p { - display: inline-block; - } +.box p { + display: inline-block; +} - .box .admonitionblock { - margin-top: 2.8rem; - } +.box .admonitionblock { + margin-top: 2.8rem; } @media screen and (max-width: 1023.5px) { @@ -37,3 +35,9 @@ flex: 0 47% !important; } } + +@media screen and (max-width: 768px) { + .box { + flex: 0 100% !important; + } +} diff --git a/src/css/main.css b/src/css/main.css index e89461a..4a4130a 100644 --- a/src/css/main.css +++ b/src/css/main.css @@ -1,3 +1,7 @@ +main { + min-width: 0; /* min-width: 0 required for flexbox to constrain overflowing elements */ +} + @media screen and (max-width: 1023.5px) { aside.toc.sidebar { display: none; @@ -11,7 +15,6 @@ @media screen and (min-width: 1024px) { main { flex: auto; - min-width: 0; /* min-width: 0 required for flexbox to constrain overflowing elements */ } main > .content { From 399e676b3342b0ae82260a7978b2b78780d7c6e7 Mon Sep 17 00:00:00 2001 From: Siegfried Weber Date: Mon, 4 Jul 2022 12:59:34 +0200 Subject: [PATCH 8/9] Remove unused page-versions.hbs --- src/partials/page-versions.hbs | 12 ------------ 1 file changed, 12 deletions(-) delete mode 100644 src/partials/page-versions.hbs diff --git a/src/partials/page-versions.hbs b/src/partials/page-versions.hbs deleted file mode 100644 index a9792db..0000000 --- a/src/partials/page-versions.hbs +++ /dev/null @@ -1,12 +0,0 @@ -{{#with page.versions}} -
- -
- {{#each this}} - {{./displayVersion}} - {{/each}} -
-
-{{/with}} From eba14c5bda9002d5efe5e6a56c2784c16762d9d5 Mon Sep 17 00:00:00 2001 From: Siegfried Weber Date: Mon, 4 Jul 2022 13:03:26 +0200 Subject: [PATCH 9/9] Fix typo which is already fixed in the documentation repository --- preview-src/index.adoc | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/preview-src/index.adoc b/preview-src/index.adoc index c7f277a..7b3b284 100644 --- a/preview-src/index.adoc +++ b/preview-src/index.adoc @@ -22,7 +22,7 @@ This documentation gives you an overview of the Stackable Data Platform, how to The Stackable Data Platform allows you to deploy, scale and manage Data infrastructure in any environment running https://kubernetes.io/[Kubernetes]. -You can find an overview of the supported components <>, as we as a full list of all supported product versions xref:operators:supported_versions.adoc[here]. +You can find an overview of the supported components <>, as well as a full list of all supported product versions xref:operators:supported_versions.adoc[here]. If you have any feedback regarding the documentation please either open an https://github.com/stackabletech/documentation/issues[issue], ask a https://github.com/stackabletech/documentation/discussions[question] or look at the source for this documentation in its https://github.com/stackabletech/documentation[repository].