From dbc3415d8f2240451134aab383f1f1aefadf19d0 Mon Sep 17 00:00:00 2001 From: Paul d'Aoust Date: Fri, 22 Mar 2024 14:33:26 -0700 Subject: [PATCH 1/9] update crane icon to work better with other icons' style --- src/pages/_includes/widgets/svg-icons.njk | 13 ++++--------- 1 file changed, 4 insertions(+), 9 deletions(-) diff --git a/src/pages/_includes/widgets/svg-icons.njk b/src/pages/_includes/widgets/svg-icons.njk index bebc434bf..74a0f6d99 100644 --- a/src/pages/_includes/widgets/svg-icons.njk +++ b/src/pages/_includes/widgets/svg-icons.njk @@ -70,7 +70,7 @@ - + @@ -184,14 +184,9 @@ {% endmacro %} {% macro craneIcon(fillColor = 'currentcolor') %} - - - - - - - - + + + {% endmacro %} {% macro toolPanelIcon(fillColor = 'currentcolor') %} From 69d7dddb6e28df42dac048a34c09310197370930 Mon Sep 17 00:00:00 2001 From: Paul d'Aoust Date: Fri, 22 Mar 2024 14:33:43 -0700 Subject: [PATCH 2/9] add light bulb icon --- src/pages/_includes/widgets/svg-icons.njk | 6 ++++++ 1 file changed, 6 insertions(+) diff --git a/src/pages/_includes/widgets/svg-icons.njk b/src/pages/_includes/widgets/svg-icons.njk index 74a0f6d99..5bd699156 100644 --- a/src/pages/_includes/widgets/svg-icons.njk +++ b/src/pages/_includes/widgets/svg-icons.njk @@ -183,6 +183,12 @@ {% endmacro %} +{% macro lightBulbIcon(fillColor = 'currentcolor') %} + + + +{% endmacro %} + {% macro craneIcon(fillColor = 'currentcolor') %} From b3bde9ddb1ed1e106f4f54f5173f9f9934f543e7 Mon Sep 17 00:00:00 2001 From: Paul d'Aoust Date: Fri, 22 Mar 2024 14:34:40 -0700 Subject: [PATCH 3/9] change core concepts icon to light bulb --- src/pages/_includes/widgets/home-tiles.njk | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/src/pages/_includes/widgets/home-tiles.njk b/src/pages/_includes/widgets/home-tiles.njk index 751a25e0e..49662f7dc 100644 --- a/src/pages/_includes/widgets/home-tiles.njk +++ b/src/pages/_includes/widgets/home-tiles.njk @@ -9,7 +9,7 @@ {% endlinkTile %} {% linkTile "/concepts/1_the_basics/", "home-tile" %} - {{ craneIcon() }} + {{ lightBulbIcon() }}

Core Concepts

Introducing Holochain basics

From e552c174aed1174a2498f3cad71df4363c2094a0 Mon Sep 17 00:00:00 2001 From: Paul d'Aoust Date: Fri, 22 Mar 2024 14:34:52 -0700 Subject: [PATCH 4/9] add build section to nav and home page --- src/pages/_data/navigation/footerLinks.json5 | 1 + src/pages/_data/navigation/headerNav.json5 | 1 + src/pages/_data/navigation/mainNav.json5 | 1 + src/pages/_includes/widgets/home-tiles.njk | 8 ++++++++ 4 files changed, 11 insertions(+) diff --git a/src/pages/_data/navigation/footerLinks.json5 b/src/pages/_data/navigation/footerLinks.json5 index 055b4e7cf..bab31a971 100644 --- 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: "Core Concepts", 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 index 13617a54b..48fd155f4 100644 --- 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: "Core Concepts", 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 index 9e530e94a..dfbfdbea6 100644 --- 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 index 49662f7dc..4680901cf 100644 --- a/src/pages/_includes/widgets/home-tiles.njk +++ b/src/pages/_includes/widgets/home-tiles.njk @@ -16,6 +16,14 @@
{% endlinkTile %} + {% linkTile "/build/", "home-tile" %} + {{ craneIcon() }} +
+

Build Guide

+

Learn how to write Holochain applications

+
+ {% endlinkTile %} + {% linkTile "/resources/", "home-tile" %} {{ toolPanelIcon() }}
From 43db49cd94fa084fdf51c3a37cdd47bd6edb5da3 Mon Sep 17 00:00:00 2001 From: Paul d'Aoust Date: Fri, 22 Mar 2024 14:52:37 -0700 Subject: [PATCH 5/9] Build section skeleton content --- src/pages/build/guide/index.md | 11 +++++++++++ src/pages/build/index.md | 7 +++++++ 2 files changed, 18 insertions(+) create mode 100644 src/pages/build/guide/index.md create mode 100644 src/pages/build/index.md diff --git a/src/pages/build/guide/index.md b/src/pages/build/guide/index.md new file mode 100644 index 000000000..23bcc7b83 --- /dev/null +++ b/src/pages/build/guide/index.md @@ -0,0 +1,11 @@ +--- +title: Holochain Build Guide +--- + +::: coreconcepts-intro +This [Build Guide](/build/guide/) organizes everything you need to know about developing Holochain applications into individual topics. Each topic page stands alone as a comprehensive, though not necessarily complete, guide to using a given feature or implementing a given functionality. There are lots of code examples, which are complete enough to make it clear how to do something while being generic enough to understand at a glance. +::: + +!!! 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. +!!! \ No newline at end of file diff --git a/src/pages/build/index.md b/src/pages/build/index.md new file mode 100644 index 000000000..a21293481 --- /dev/null +++ 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. \ No newline at end of file From 89b274dd8c5cd77561f7905ceaf2a8d61f943aed Mon Sep 17 00:00:00 2001 From: Paul d'Aoust Date: Fri, 22 Mar 2024 20:19:49 -0700 Subject: [PATCH 6/9] fix broken call to lightBulbIcon on home-tiles.njk --- src/pages/_includes/widgets/home-tiles.njk | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/src/pages/_includes/widgets/home-tiles.njk b/src/pages/_includes/widgets/home-tiles.njk index 4680901cf..add0cb674 100644 --- 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 %}
{% linkTile "/get-started/", "home-tile" %} {{ rocketshipIcon() }} From 97aa782c8ab144a45bb8fcd5f55a6c3c6eaf05cb Mon Sep 17 00:00:00 2001 From: Paul d'Aoust Date: Fri, 22 Mar 2024 21:19:31 -0700 Subject: [PATCH 7/9] whoa those new icons were big --- src/pages/_includes/widgets/svg-icons.njk | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/src/pages/_includes/widgets/svg-icons.njk b/src/pages/_includes/widgets/svg-icons.njk index 5bd699156..d10a72c16 100644 --- a/src/pages/_includes/widgets/svg-icons.njk +++ b/src/pages/_includes/widgets/svg-icons.njk @@ -184,13 +184,13 @@ {% endmacro %} {% macro lightBulbIcon(fillColor = 'currentcolor') %} - + {% endmacro %} {% macro craneIcon(fillColor = 'currentcolor') %} - + {% endmacro %} From 319ae20cb2ac771ad360ad6442d6def67f5e8283 Mon Sep 17 00:00:00 2001 From: Paul d'Aoust Date: Mon, 25 Mar 2024 09:02:56 -0700 Subject: [PATCH 8/9] remove self-referential link from build guide --- src/pages/build/guide/index.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/src/pages/build/guide/index.md b/src/pages/build/guide/index.md index 23bcc7b83..218b0b099 100644 --- a/src/pages/build/guide/index.md +++ b/src/pages/build/guide/index.md @@ -3,7 +3,7 @@ title: Holochain Build Guide --- ::: coreconcepts-intro -This [Build Guide](/build/guide/) organizes everything you need to know about developing Holochain applications into individual topics. Each topic page stands alone as a comprehensive, though not necessarily complete, guide to using a given feature or implementing a given functionality. There are lots of code examples, which are complete enough to make it clear how to do something while being generic enough to understand at a glance. +This Build Guide organizes everything you need to know about developing Holochain applications into individual topics. Each topic page stands alone as a comprehensive, though not necessarily complete, guide to using a given feature or implementing a given functionality. There are lots of code examples, which are complete enough to make it clear how to do something while being generic enough to understand at a glance. ::: !!! note Coming soon! From d084409618eed883a3304b28b5296b593e6ac94f Mon Sep 17 00:00:00 2001 From: Paul d'Aoust Date: Mon, 25 Mar 2024 09:07:33 -0700 Subject: [PATCH 9/9] improve wording on build guide landing page --- src/pages/build/guide/index.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/src/pages/build/guide/index.md b/src/pages/build/guide/index.md index 218b0b099..8f162b9db 100644 --- a/src/pages/build/guide/index.md +++ b/src/pages/build/guide/index.md @@ -3,7 +3,7 @@ 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, though not necessarily complete, guide to using a given feature or implementing a given functionality. There are lots of code examples, which are complete enough to make it clear how to do something while being generic enough to understand at a glance. +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!