more work on content, developing the pattern language

googlefonts · Sep 15, 2023 · 951fb13 · 951fb13
2 parents 3fe6c25 + d3347bb
commit 951fb13
Show file tree

Hide file tree

Showing 27 changed files with 692 additions and 401 deletions.
diff --git a/css/style.sass b/css/style.sass
@@ -39,7 +39,7 @@ h2
   margin-top: 0.6em
 
 ul, ol
-  padding-left: 1.5em
+  padding-left: 1em
 
 /* syntax highlighter */
 

diff --git a/explanations/documentation.md b/explanations/documentation.md
@@ -1,7 +1,7 @@
 ---
-title: Documentation overview
-layout: default
-permalink: /explanations/documentation/
+title     : Documentation overview
+layout    : default
+permalink : /explanations/documentation/
 ---
 
 <nav aria-label="breadcrumb">
@@ -22,7 +22,7 @@ permalink: /explanations/documentation/
 - with input from users and developers, make it better over time
 
 <div class="alert alert-warning" role="alert" markdown='1'>
-<i class="bi bi-exclamation-circle me-1"></i> keep the docs up-to-date in relation to the app!
+<i class="bi bi-exclamation-circle me-1"></i> Keep the docs up-to-date in relation to the app!
 {: .mb-0 }
 </div>
 
@@ -126,7 +126,8 @@ images
 
 
 <div class="alert alert-primary mt-3" role="alert" markdown='1'>
-see also:  
+#### See also
+{: .alert-heading}
 
 - [Reporting errors, suggesting changes, etc.](#)
 - [Editing the documentation](#)

diff --git a/explanations/explanations.md b/explanations/explanations.md
@@ -1,14 +1,14 @@
 ---
-title: Explanations
-layout: default
-permalink: /explanations/
+title     : Explanations
+layout    : default
+permalink : /explanations/
+draft     : true
 ---
 
 theoretical knowledge · understanding-oriented · useful when studying
 {: .lead }
 
-- [Welcome to Fontra](welcome-to-fontra) <span class='text-warning'>✔</span>
-- [Workspace overview](workspace) <span class='text-warning'>✔</span>
-- [Features overview](#)
-- [Documentation overview](documentation) <span class='text-success'>✔</span>
+- [Welcome to Fontra](welcome-to-fontra)
+- [Features overview](features)
+- [Documentation overview](documentation)
 - ...
diff --git a/explanations/features-overview.md b/explanations/features-overview.md
@@ -0,0 +1,16 @@
+---
+title     : Features overview
+layout    : default
+permalink : /explanations/features/
+draft     : true
+---
+
+<nav aria-label="breadcrumb">
+  <ol class="breadcrumb small">
+    <li class="breadcrumb-item"><a href="{{ site.url }}">Index</a></li>
+    <li class="breadcrumb-item"><a href="../../explanations">Explanations</a></li>
+    <li class="breadcrumb-item active" aria-current="page">{{ page.title }}</li>
+  </ol>
+</nav>
+
+...
diff --git a/explanations/workspace.md b/explanations/workspace.md
diff --git a/how-tos/building-fontra-from-source.md b/how-tos/building-fontra-from-source.md
@@ -0,0 +1,17 @@
+---
+title     : Building Fontra from source
+layout    : default
+permalink : /how-tos/building-fontra-from-source/
+draft     : true
+---
+
+<nav aria-label="breadcrumb">
+  <ol class="breadcrumb small">
+    <li class="breadcrumb-item"><a href="{{ site.url }}">Index</a></li>
+    <li class="breadcrumb-item"><a href="../../how-tos">How-Tos</a></li>
+    <li class="breadcrumb-item active" aria-current="page">{{ page.title }}</li>
+  </ol>
+</nav>
+
+...
+
diff --git a/how-tos/how-tos.md b/how-tos/how-tos.md
@@ -1,21 +1,21 @@
 ---
-title: How-Tos
-layout: default
-permalink: /how-tos/
+title     : How-Tos
+layout    : default
+permalink : /how-tos/
 ---
 
 practical steps · problem-oriented · useful when working
 {: .lead }
 
 ### Installation
 
-- [Installing Fontra Pak on your computer](installing-fontra-pak) <span class='text-success'>✔</span>
+- [Installing Fontra Pak on your computer](installing-fontra-pak)
 - [Running Fontra on a web server](#)
-- [Building Fontra from source](#)
+- [Building Fontra from source](building-fontra-from-source)
 
 ### Editing fonts
 
-- [Opening a UFO or designspace file](opening-ufo-designspace) ✔
+- [Opening a UFO or designspace file](opening-ufo-designspace)
 - [Creating new glyphs at specific locations](#)
 - [Creating variable components](#)
 - ...

diff --git a/how-tos/installing-fontra-pak.md b/how-tos/installing-fontra-pak.md
@@ -1,7 +1,8 @@
 ---
-title: Installing Fontra Pak on your computer
-layout: default
-permalink: /how-tos/installing-fontra-pak/
+title     : Installing Fontra Pak on your computer
+layout    : default
+permalink : /how-tos/installing-fontra-pak/
+draft     : true
 ---
 
 <nav aria-label="breadcrumb">
@@ -12,7 +13,7 @@ permalink: /how-tos/installing-fontra-pak/
   </ol>
 </nav>
 
-Fontra can be installed locally using [Fontra Pak], a self-contained application which allows you to edit local files in your browser using Fontra. The installer is available only for **macOS** and **Windows**. Linux users can [build Fontra from source](#).
+Fontra can be installed locally using [Fontra Pak], a self-contained application which allows you to edit local files in your browser using Fontra. The installer is available only for **macOS** and **Windows**. Linux users can [build Fontra from source].
 
 Follow the steps below to install Fontra on your machine.
 
@@ -22,19 +23,19 @@ Follow the steps below to install Fontra on your machine.
 
 3. Click on the topmost “Build Application” link to go the worflow page.
 
-    ![]({{ site.url }}/images/fontra-actions-build.png)
+    ![]({{ site.url }}/images/fontra-actions-build.png){: .img-fluid}
 
 4. In the *Artifacts* section of that page, choose the appropriate installer for your platform and click to download.
 
-    ![]({{ site.url }}/images/fontra-download-installer.png)
+    ![]({{ site.url }}/images/fontra-download-installer.png){: .img-fluid}
 
 5. Unzip and double-click the package, then drag the Fontra Pak icon into the *Applications* folder to conclude the installation.
 
-    ![]({{ site.url }}/images/fontra-pak-installer.png)
-
+    ![]({{ site.url }}/images/fontra-pak-installer.png){: .img-fluid}
 
 
 [Fontra Pak]: http://github.com/googlefonts/fontra-pak
+[build Fontra from source]: ../building-fontra-from-source
 [GitHub]: http://github.com
 [Actions]: http://github.com/googlefonts/fontra-pak/actions
 
diff --git a/how-tos/opening-ufo-designspace.md b/how-tos/opening-ufo-designspace.md
@@ -1,7 +1,8 @@
 ---
-title: Opening a UFO or designspace file in Fontra
-layout: default
-permalink: /how-tos/opening-ufo-designspace/
+title     : Opening a UFO or designspace file in Fontra
+layout    : default
+permalink : /how-tos/opening-ufo-designspace/
+draft     : true
 ---
 
 <nav aria-label="breadcrumb">
@@ -12,18 +13,19 @@ permalink: /how-tos/opening-ufo-designspace/
   </ol>
 </nav>
 
-Fontra supports the [UFO] and [designspace] formats natively. Follow the steps below to open your local files in the browser using the Fontra Pak app.
+Fontra supports the [UFO] and [designspace] formats natively.
 
+Follow the steps below to open your local files in the browser using the Fontra Pak app.
 
-1. Double-click the Fontra Pak application icon to open the start-up window.
-
-    ![]({{ site.url }}/images/fontra-pak-app.png)
+1. Double-click the Fontra Pak icon to open the start-up window.
 
+    ![]({{ site.url }}/images/fontra-pak-app.png){: .img-fluid }
 
 2. Drag a `.ufo` or `.designspace` file into the start-up window to launch Fontra in your default browser.
 
-
     ![]({{ site.url }}/images/fontra-browser-open.png){: .img-fluid }
 
-
 That's it! Have fun using Fontra to design and build your fonts.
+
+[UFO]: #
+[designspace]: #
diff --git a/index.md b/index.md
@@ -21,7 +21,7 @@ Quickstart
 ----------
 
 - [Installing Fontra Pak on your computer](how-tos/installing-fontra-pak/)
-- [Workspace overview](explanations/workspace/)
+- [Workspace overview](reference/workspace/)
 - [Opening a UFO or designspace file](how-tos/opening-ufo-designspace)