Merge pull request #437 from holochain/feat/build-landing-page

Add the skeleton of a 'Build' section
holochain · Mar 25, 2024 · 6b3d180 · 6b3d180
2 parents b3a1734 + d084409
commit 6b3d180
Show file tree

Hide file tree

Showing 7 changed files with 41 additions and 11 deletions.
diff --git a/src/pages/_data/navigation/footerLinks.json5 b/src/pages/_data/navigation/footerLinks.json5
@@ -5,6 +5,7 @@
       links: [
         { title: "Get Started", url: "/get-started/" },
         { title: "Learn", url: "/concepts/1_the_basics/" },
+        { title: "Build", url: "/build/" },
         { title: "Resources", url: "/resources/" },
       ]
     },

diff --git a/src/pages/_data/navigation/headerNav.json5 b/src/pages/_data/navigation/headerNav.json5
@@ -2,6 +2,7 @@
   links: [
     { title: "Get Started", url: "/get-started/", class:"" },
     { title: "Learn", url: "/concepts/1_the_basics/", class:"" },
+    { title: "Build", url: "/build", class:"" },
     { title: "Resources", url: "/resources/", class:"" },
     { title: "Get Involved", url: "/get-involved/", class:"" },
   ]

diff --git a/src/pages/_data/navigation/mainNav.json5 b/src/pages/_data/navigation/mainNav.json5
@@ -25,6 +25,7 @@
         { title: "Lifecycle Events", url: "/concepts/11_lifecycle_events/" },
       ]
     },
+    { title: "Build", url: "/build/", children: []},
     { title: "Resources", url: "/resources/", children: [
         { title: "HDK (Rust)", url: "https://docs.rs/hdk", external: true },
         { title: "App API reference", url: "https://docs.rs/holochain_conductor_api/latest/holochain_conductor_api/enum.AppRequest.html", external: true },

diff --git a/src/pages/_includes/widgets/home-tiles.njk b/src/pages/_includes/widgets/home-tiles.njk
@@ -1,4 +1,4 @@
-{% from "widgets/svg-icons.njk" import rocketshipIcon, craneIcon, toolPanelIcon, personReadingIcon %}
+{% from "widgets/svg-icons.njk" import rocketshipIcon, lightBulbIcon, craneIcon, toolPanelIcon, personReadingIcon %}
 <div id="home-tiles">
     {% linkTile "/get-started/", "home-tile" %}
       {{ rocketshipIcon() }}
@@ -9,13 +9,21 @@
     {% endlinkTile %}
 
     {% linkTile "/concepts/1_the_basics/", "home-tile" %}
-      {{ craneIcon() }}
+      {{ lightBulbIcon() }}
       <div class="text-wrapper">
         <h2>Core Concepts</h2>
         <p>Introducing Holochain basics</p>
       </div>
     {% endlinkTile %}
 
+    {% linkTile "/build/", "home-tile" %}
+      {{ craneIcon() }}
+      <div class="text-wrapper">
+        <h2>Build Guide</h2>
+        <p>Learn how to write Holochain applications</p>
+      </div>
+    {% endlinkTile %}
+
     {% linkTile "/resources/", "home-tile" %}
       {{ toolPanelIcon() }}
       <div class="text-wrapper">

diff --git a/src/pages/_includes/widgets/svg-icons.njk b/src/pages/_includes/widgets/svg-icons.njk
@@ -70,7 +70,7 @@
       <stop offset=".37" stop-color="#ff980e"/>
       <stop offset=".53" stop-color="#ff3647"/>
       <stop offset=".7" stop-color="#e31587"/>
-    </linearGradient>    
+    </linearGradient>
     <radialGradient id="b" cx="87.4%" cy="-12.9%" r="128%" gradientTransform="translate(0.874,0),scale(0.8,1),translate(-0.87,0.129)">
       <stop offset=".13" stop-color="#ffbd4f"/>
       <stop offset=".28" stop-color="#ff980e"/>
@@ -183,15 +183,16 @@
   </svg>
 {% endmacro %}
 
+{% macro lightBulbIcon(fillColor = 'currentcolor') %}
+  <svg width="55" height="55" version="1.1" viewBox="0 0 1200 1200" xmlns="http://www.w3.org/2000/svg">
+    <path d="m540.76 934.78v-213.04l-84.781-115.22c-5.4336-8.6953-4.3477-20.652 4.3477-27.176s21.738-4.3477 28.262 4.3477l86.957 119.57c3.2617 3.2617 4.3477 7.6094 4.3477 11.957v219.57h40.219v-219.57c0-4.3477 1.0859-8.6953 4.3477-11.957l86.957-119.57c6.5234-8.6953 19.566-10.871 28.262-4.3477 8.6953 6.5234 9.7812 18.477 4.3477 27.176l-84.781 115.22v213.04h52.176c5.4336-93.477 44.566-148.91 82.609-202.18 34.781-48.914 69.566-97.824 69.566-178.26 0-71.738-29.348-138.04-77.176-185.87-47.824-47.824-114.13-77.176-186.96-77.176-71.738 0-138.04 29.348-185.87 77.176-47.824 47.824-77.176 114.13-77.176 185.87 0 80.434 34.781 129.35 69.566 178.26 38.043 53.262 77.176 108.7 82.609 202.18h52.176zm372.82-131.52c-7.6094-7.6094-7.6094-20.652 0-28.262 7.6094-7.6094 19.566-7.6094 28.262 0l76.086 77.176c7.6094 7.6094 7.6094 19.566 0 27.176s-19.566 7.6094-27.176 0l-77.176-76.086zm-655.43-28.262c8.6953-7.6094 20.652-7.6094 28.262 0 7.6094 7.6094 7.6094 20.652 0 28.262l-77.176 76.086c-7.6094 7.6094-19.566 7.6094-27.176 0s-7.6094-19.566 0-27.176l76.086-77.176zm-66.305-280.43c10.871 0 19.566 8.6953 19.566 19.566s-8.6953 19.566-19.566 19.566h-108.7c-10.871 0-19.566-8.6953-19.566-19.566s8.6953-19.566 19.566-19.566zm925 0c10.871 0 19.566 8.6953 19.566 19.566s-8.6953 19.566-19.566 19.566h-108.7c-10.871 0-19.566-8.6953-19.566-19.566s8.6953-19.566 19.566-19.566zm-772.82-269.57c7.6094 7.6094 7.6094 19.566 0 27.176-7.6094 7.6094-19.566 7.6094-27.176 0l-77.176-77.176c-7.6094-7.6094-7.6094-19.566 0-27.176 7.6094-7.6094 19.566-7.6094 27.176 0zm539.13 27.176c-7.6094 7.6094-19.566 7.6094-27.176 0-7.6094-7.6094-7.6094-19.566 0-27.176l77.176-77.176c7.6094-7.6094 19.566-7.6094 27.176 0 7.6094 7.6094 7.6094 19.566 0 27.176zm-263.04-123.91c0 10.871-9.7812 19.566-20.652 19.566-9.7812 0-19.566-8.6953-19.566-19.566l1.0859-108.7c0-10.871 8.6953-19.566 19.566-19.566 9.7812 0 19.566 8.6953 19.566 19.566zm39.129 1042.4c0 7.6094-3.2617 15.219-8.6953 20.652-5.4336 5.4336-13.043 8.6953-20.652 8.6953h-59.781c-7.6094 0-15.219-3.2617-20.652-8.6953v-1.0859c-5.4336-4.3477-8.6953-11.957-8.6953-19.566h-22.824c-18.477 0-35.871-8.6953-48.914-20.652-11.957-13.043-19.566-29.348-19.566-48.914v-146.74-3.2617c-1.0859-91.305-39.129-144.57-75-195.65-39.129-54.348-77.176-107.61-77.176-201.09 0-82.609 33.695-158.7 89.129-213.04 54.348-55.434 130.43-89.129 213.04-89.129 83.695 0 159.78 33.695 214.13 89.129 55.434 54.348 89.129 130.43 89.129 213.04 0 93.477-38.043 146.74-77.176 201.09-35.871 51.086-73.914 104.35-75 195.65v3.2617 146.74c0 19.566-7.6094 35.871-19.566 48.914-13.043 11.957-30.434 20.652-48.914 20.652h-22.824zm52.176-195.65h-222.82v57.609h222.82zm0 96.738h-222.82v29.348c0 8.6953 3.2617 15.219 8.6953 20.652s11.957 8.6953 20.652 8.6953h164.13c8.6953 0 15.219-3.2617 20.652-8.6953s8.6953-11.957 8.6953-20.652z" fill="{{ fillColor }}"/>
+  </svg>
+{% endmacro %}
+
 {% macro craneIcon(fillColor = 'currentcolor') %}
-  <svg width="59" height="51" viewBox="0 0 59 51" fill="none" xmlns="http://www.w3.org/2000/svg">
-    <path d="M58.3894 2.91759L58.0891 2.58695C58.18 2.66238 58.2828 2.71843 58.3894 2.77517V2.91759Z" fill="{{ fillColor }}"/>
-    <path d="M42.9574 2.28117C43.0515 2.30145 43.1417 2.33403 43.2429 2.33403C43.9342 2.33403 44.4959 1.80972 44.4959 1.16737C44.4959 0.523426 43.9335 0 43.2429 0C42.5499 0 41.9875 0.523408 41.9875 1.16737C41.9875 1.34624 6.95488 14.4744 6.95488 14.4744H5.86976V16.5231L4.70379 22.1573L4.67258 23.6124H5.43797V24.1964H5.22879L5.09116 25.93L2.84964 46.9674H1.60143C0.717092 46.9674 0 47.6838 0 48.5688C0 49.4531 0.717092 50.1695 1.60143 50.1695H12.2344C13.1188 50.1695 13.8352 49.4531 13.8352 48.5688C13.8352 47.6838 13.1188 46.9674 12.2344 46.9674H11.917L12.2344 25.1857L42.6203 3.01496V19.3903H42.1939C42.1939 19.7489 42.4592 20.0397 42.7873 20.0397C43.1163 20.0397 43.3816 19.7487 43.3816 19.3903H42.9569L42.9571 2.62004L42.9574 2.28117ZM27.5265 7.49699L14.7491 12.5984L10.0225 13.738L27.5265 7.49699ZM8.29278 14.4999L12.5682 13.4686L8.29278 15.1758V14.4999ZM6.20509 14.8112H7.95737V15.5889L7.40365 16.2873H6.20438V14.8112H6.20509ZM7.77852 22.9364V22.4994H7.95739V23.4452L7.81429 23.445V23.3757H7.51397V23.445H7.24941V22.4991H7.51397V22.9362L7.77852 22.9364ZM9.2407 22.917V23.0556H9.05089L9.03539 23.6132H8.99802V23.3766H8.29254V22.7234H8.87815V22.9177H9.24068L9.2407 22.917ZM10.6851 23.7786L11.6613 25.0043L8.70112 25.1809L10.6851 23.7786ZM9.03793 24.5324L7.8323 25.3848L7.6892 24.5324H9.03793ZM6.91378 22.164V23.613H6.84451L6.83676 16.6217H7.43013L7.43469 22.1641L6.91378 22.164ZM5.03848 22.1929L5.733 18.9472V22.1929H5.03848ZM5.733 23.613V24.197H5.56255V23.613H5.733ZM3.18727 46.9673L5.42331 25.9667L5.53769 24.5325H5.73206V25.9519H6.53869L5.70721 46.9677L3.18727 46.9673ZM6.24476 46.9673L7.08237 24.5323H7.34988L8.31833 46.9673H6.24476ZM11.4893 46.9673H8.67125L7.86234 25.5642L11.7887 25.3332L11.4893 46.9673ZM12.0245 24.922L11.2523 23.9535L12.7893 24.365L12.0245 24.922ZM13.0932 24.0998L11.018 23.5452L13.0932 22.0798V24.0998ZM13.4284 23.8993V22.0652L15.4374 22.4332L13.4284 23.8993ZM13.5599 21.7487L15.4803 20.3922L15.5619 22.1165L13.5599 21.7487ZM15.897 22.0978L15.8177 20.4061L17.6487 20.8206L15.897 22.0978ZM15.9164 20.0841L17.7341 18.8001L17.8143 20.515L15.9164 20.0841ZM18.1472 20.456L18.0695 18.7947L19.7986 19.2504L18.1472 20.456ZM20.0255 18.9642L18.1884 18.4789L20.0255 17.1816V18.9642ZM20.3607 18.8421V17.1458L22.0858 17.5829L20.3607 18.8421ZM22.3276 17.2967L20.5122 16.8378L22.3276 15.556V17.2967ZM22.6628 17.162V15.8491L23.3145 16.6844L22.6628 17.162ZM23.8466 16.2973L23.2142 15.567L24.4493 15.857L23.8466 16.2973ZM24.6283 15.5551L22.9032 15.15L24.6283 13.9305V15.5551ZM24.9642 15.4829V13.9498L26.5811 14.3037L24.9642 15.4829ZM26.8302 14.0152L25.0583 13.6272L26.8302 12.375V14.0152ZM27.1654 13.876V12.504L28.6369 12.8027L27.1654 13.876ZM28.829 12.4992L27.1396 12.157L28.829 10.9646V12.4992ZM29.1635 12.4183V11.0828L30.6428 11.3394L29.1635 12.4183ZM30.726 11.0128L29.1464 10.7392L30.726 9.62378V11.0128ZM17.7655 18.3675L15.4757 19.9853L15.4609 19.9815L15.4616 19.9963L13.0979 21.6654L13.0933 21.6647L10.5966 23.4318L10.4761 23.5181L9.35449 24.3106L9.37636 23.3921H9.5762V22.5825H9.21367V22.3888H8.29288V22.1637H7.77016L7.76469 16.4548H7.7002L8.29287 15.7051V15.5372L14.856 12.916L30.9845 9.02704L17.7655 18.3675ZM31.0614 11.0338V9.63226L32.6932 9.84463L31.0614 11.0338ZM31.1726 9.30869L31.8587 8.82334L32.4234 9.46955L31.1726 9.30869ZM32.8517 9.30163L32.1408 8.62484L32.8517 8.1224V9.30163ZM33.1869 9.4821V8.14271L34.5318 8.50136L33.1869 9.4821ZM34.6462 8.18488L33.2813 7.81939L34.6462 6.85345V8.18488ZM34.983 8.17235V6.8455L36.3526 7.17362L34.983 8.17235ZM36.4452 6.85098L35.1058 6.5306L36.4452 5.58403V6.85098ZM31.7224 8.50298L17.0364 12.0465L35.9965 4.47541L38.8999 3.44023L31.7224 8.50298ZM38.1379 4.38844V5.45781L37.0054 5.1871L38.1379 4.38844ZM36.7807 6.86031V5.47898L38.2072 5.82032L36.7807 6.86031ZM38.4733 5.62505V4.25305L39.9768 4.52922L38.4733 5.62505ZM40.0654 4.20568L38.7424 3.96232L40.0654 3.02829V4.20568ZM40.4013 4.21958V3.02719L41.4839 3.42937L40.4013 4.21958ZM41.6311 3.12764L40.5127 2.71224L40.641 2.62132L41.6311 2.22552L41.6311 3.12764ZM41.967 3.07705V2.09087L42.0073 2.07537L42.5384 2.65941L41.967 3.07705Z" fill="{{ fillColor }}"/>
-    <path d="M36.5732 19.276H49.8032V22.913H36.5732V19.276Z" fill="{{ fillColor }}"/>
-    <path d="M29.7659 44.9952H56.6115V50.3322H29.7659V44.9952Z" fill="{{ fillColor }}"/>
-    <path d="M30.8486 38.8824H55.5277V44.2195H30.8486V38.8824Z" fill="{{ fillColor }}"/>
-    <path d="M32.3191 32.7697H54.057V38.1083H32.3191V32.7697Z" fill="{{ fillColor }}"/>
-</svg>
+  <svg width="55" height="55" version="1.1" viewBox="0 0 1200 1200" xmlns="http://www.w3.org/2000/svg">
+    <path d="m236.53 1016h223.78l0.046875-23.906c-0.046875-13.219-10.781-23.953-24-23.953h-175.87c-13.219 0-23.953 10.734-24 23.953v23.906zm243.94-824.76-43.453-87.75h-138.66v87.75zm-146.39-29.531c-7.9688 0-14.391-6.4219-14.391-14.391s6.4219-14.391 14.391-14.391h83.719c7.9688 0 14.391 6.4219 14.391 14.391s-6.4219 14.391-14.391 14.391zm183.94 58.266 0.046875 82.453h447.74l-8.8125-26.812h-351c-7.9688 0-14.391-6.4688-14.391-14.391 0-7.9688 6.4219-14.438 14.391-14.438h341.53l-8.8125-26.812zm-119.48 400.92v-76.781h-100.22v76.781zm0 105.52v-76.781h-100.22v76.781zm0 105.52v-76.781h-100.22v76.781zm0 107.48v-78.75h-100.22v78.75zm0-500.81h-100.22v76.781h100.22zm-108-107.48-19.734 78.75h155.29l-19.734-78.75zm-20.906-214.97-110.81 75.094h110.81zm469.78 75.094h-226.92l-39.141-79.031 266.02 79.031zm143.34 200.02 21.188-60.094h-98.719l21.141 60.094zm-393.52-115.69h-106.31c-7.9688 0-14.391-6.4688-14.391-14.391 0-7.9688 6.4219-14.438 14.391-14.438h106.31v-26.766h-362.81v82.453h362.81zm419.9 687v51.609h67.734v-51.609zm0-92.391v63.609h67.734v-63.609zm0-80.391v51.609h67.734v-51.609zm-109.12 51.609v-51.609l-67.781-0.046874v51.609zm0 92.391v-63.609l-67.781-0.046876v63.609zm0 80.391v-51.609h-67.781v51.609zm216.79-461.44v-51.609h-324.52v51.609zm-11.203 543.84h51.609v-389.21h-51.609zm-96.516 0h67.734v-53.672h-67.688v53.672zm-80.391 0h51.609v-389.21h-51.609zm-96.516 0h67.734v-53.672h-67.688v53.672zm-80.391 0h51.609v-389.21h-51.609zm-459.42 0h312l-37.078-51.797h-237.79l-37.078 51.797zm-117.98 28.781c-7.9219 0-14.391-6.4688-14.391-14.438 0-7.9219 6.4688-14.391 14.391-14.391h82.781l50.625-70.734v-33.703c0.09375-29.062 23.625-52.594 52.688-52.688h9.1406v-500.81h-17.203c-4.4062 0-8.5781-2.0625-11.297-5.5312s-3.7031-8.0156-2.625-12.281l22.453-89.625h-148.87c-7.9688 0-14.391-6.4688-14.391-14.438v-111.14c0-5.25 2.8594-10.078 7.4531-12.609l169.64-114.94c2.5781-2.1094 5.8125-3.2812 9.1406-3.2812h161.9l4.0312 0.60938 390.14 115.88h109.08c6.5156 0 12.281 4.4531 13.875 10.781 12.094 36.797 24.188 73.594 36.281 110.3 3.0469 9.3281-5.1094 15.938-13.641 18.797h-51.328l-27.609 78.375h0.046875c-1.7812 6.1875-7.4062 10.453-13.828 10.453h-24v52.406h162.32c7.9688 0 14.391 6.4688 14.391 14.438v80.391c0 7.9219-6.4219 14.391-14.391 14.391h-353.29c-7.9219 0-14.391-6.4688-14.391-14.391v-80.391c0-7.9688 6.4688-14.438 14.391-14.438h162.28v-52.406h-24c-6.0938 0-11.531-3.8438-13.547-9.6094l-27.891-79.219-338.81 0.046874 22.266 88.781c1.3594 4.3594 0.5625 9.1406-2.1562 12.797-2.7188 3.7031-6.9844 5.8594-11.578 5.9062h-17.203v500.76h9.1406c29.062 0.09375 52.594 23.625 52.688 52.688v33.75l50.625 70.734h83.438l-0.046875-403.6c0-7.9219 6.4688-14.391 14.391-14.391h80.391c7.9688 0 14.438 6.4688 14.438 14.391v68.062h67.734v-68.062c0-7.9219 6.4688-14.391 14.391-14.391h80.391c7.9688 0 14.438 6.4688 14.438 14.391v68.062h67.734v-68.062c0-7.9219 6.4688-14.391 14.391-14.391h80.391c7.9688 0 14.438 6.4688 14.438 14.391v403.6h39.609-0.046875c7.9688 0 14.438 6.4688 14.438 14.391 0 7.9688-6.4688 14.438-14.438 14.438z" fill-rule="evenodd" fill="{{ fillColor }}"/>
+  </svg>
 {% endmacro %}
 
 {% macro toolPanelIcon(fillColor = 'currentcolor') %}

diff --git a/src/pages/build/guide/index.md b/src/pages/build/guide/index.md
@@ -0,0 +1,11 @@
+---
+title: Holochain Build Guide
+---
+
+::: coreconcepts-intro
+This Build Guide organizes everything you need to know about developing Holochain applications into individual topics. Each topic page stands alone as a comprehensive guide to using a given feature or implementing a given functionality. There are lots of code examples which make it clear how to do something yet are generic enough to be universally useful. These examples may not cover every single use case, though, so we'll point you to the reference documentation often.
+:::
+
+!!! note Coming soon!
+This guide is 'under construction', as we used to say in the early days of the web. Expect more content to be rapidly published in the first half of 2024.
+!!!
diff --git a/src/pages/build/index.md b/src/pages/build/index.md
@@ -0,0 +1,7 @@
+---
+title: Build on Holochain
+---
+
+Now that you've learned Holochain's [core concepts](/concepts/1_the_basics), [installed Holochain](/get-started/#2-installing-holochain-development-environment), and [built a basic hApp](/get-started/3-forum-app-tutorial/), it's time to deepen your Holochain knowledge to the point where you feel capable of using its full feature set to build complex applications.
+
+The [Build Guide](/build/guide/) expands on the Core Concepts guide with code examples and a deeper level of detail on how to use various APIs and what they're doing in the background. Each page in this guide brings together all the functions and concepts you need in order to get a particular thing done.