push the step changes (#28)

Author: colegoldsmith

preview-src/examples/quickstart.adoc

@@ -19,7 +19,8 @@ image::ROOT:template-examples/quickstart-overview.png["Tutorial overview"]
 
 To get started, ensure you have an {astra-link}[active Astra account] with the requisite permissions.
 
-=== [.step]#1# Install the Python SDK and open a Python REPL.
+[.step]
+=== Install the Python SDK and open a Python REPL.
 
 [source,shell]
 ----
@@ -36,7 +37,8 @@ python
 Additional clients, such as {astra-nodejs-link}[Node.js] and {astra-json-link}[JSON API], are available.
 ====
 
-=== [.step]#2# Connect to Astra and create a database.
+[.step]
+=== Connect to Astra and create a database.
 
 [source,python]
 ----
@@ -60,7 +62,8 @@ db.create_table(table_name)
 
 == Core steps
 
-=== [.step]#3# Prepare and ingest data.
+[.step]
+=== Prepare and ingest data.
 
 [source,python]
 ----
@@ -74,7 +77,8 @@ for data in sample_vectors:
     db.insert_record(table_name, data)
 ----
 
-=== [.step]#4# Perform a similarity search.
+[.step]
+=== Perform a similarity search.
 
 [source,python]
 ----
@@ -83,7 +87,8 @@ query_vector = [0.2, 0.3, 0.4]
 results = db.similarity_search(table_name, query_vector, k=5)
 ----
 
-=== [.step]#5# Show the results.
+[.step]
+=== Show the results.
 
 [source,python]
 ----
@@ -94,7 +99,8 @@ for result in results:
 
 == Cleanup
 
-=== [.step]#6# Delete all resources.
+[.step.step-reset]
+=== Delete all resources.
 
 [source,python]
 ----

src/css/doc.css

@@ -8,6 +8,7 @@
   padding-right: calc(24 / var(--rem-base) * 1rem);
   padding-left: calc(24 / var(--rem-base) * 1rem);
   padding-bottom: var(--ds-space-10);
+  counter-reset: step;
 }
 
 @media screen and (min-width: 1024px) {
@@ -995,8 +996,24 @@
   padding: 0.25rem 0;
 }
 
-.doc .conum[data-value],
-.doc .step {
+.step-reset {
+  counter-reset: step;
+}
+
+.doc .step h2::before,
+.doc .step h3::before,
+.doc .step h4::before {
+  counter-increment: step;
+  content: counter(step) ". ";
+}
+
+.doc .step h2 .anchor,
+.doc .step h3 .anchor,
+.doc .step h4 .anchor {
+  margin-left: -4.25ex;
+}
+
+.doc .conum[data-value] {
   @include text-overline;
 
   color: var(--ds-text-inverse);
@@ -1020,12 +1037,6 @@
   display: none;
 }
 
-.doc .step {
-  position: relative;
-  top: -0.25em;
-  margin-right: var(--ds-space-q);
-}
-
 .doc hr {
   border: solid var(--section-divider-color);
   border-width: 2px 0 0;

src/helpers/stepcount.js

@@ -1,7 +1,7 @@
 'use strict'
 
 module.exports = (html) => {
-  const matches = html.toString().match(/class="step"/g)
+  const matches = html.toString().match(/class(?=="((.*?\s)?step(\s.*?)?)")/g)
   if (!matches) return undefined
   return matches.length
 }