Packages page (#344)

 The page provides a streamlined entry to exploring the Swift package ecosystem. It has common categories of packages, as well as categories of interest. When you select a category, it provides a sample of some widely-used packages for that category, with information to help you explore further. It’s a great way to get a sense of the variety of packages available for Swift.

In addition to finding common categories of packages, you can also browse new and interesting work from across the Swift package ecosystem with the Community Showcase

Author: daveverwer

.gitignore

@@ -10,8 +10,9 @@ xcuserdata
 # Built site content.
 /_site
 
-# Jekyll metadata
+# Temporary Jekyll files
 .jekyll-metadata
+.jekyll-cache
 
 # Asset Cache
 .asset-cache

_config.yml

@@ -3,7 +3,7 @@ title: Swift.org
 description: "Swift is a general-purpose programming language built using a modern approach to safety, performance, and software design patterns."
 timezone: America/Lower_Princes
 exclude: ["README.md", "config.ru", "Gemfile", "Gemfile.lock", "Procfile", "vendor"]
-safe: true
+safe: false
 future: true
 
 kramdown:

_data/navigation.yml

@@ -37,6 +37,15 @@
           name: snapshots
         - title: Installing Swift
           name: installing-swift
+    - title: Packages
+      url: /packages/
+      sections:
+        - title: Package Ecosystem
+          name: package-ecosystem
+        - title: Create Your Own
+          name: create-your-own
+        - title: Advanced Search
+          name: advanced-search
     - title: Platform Support
       url: /platform-support/
       sections:

_data/packages/packages.yml

@@ -0,0 +1,17 @@
+module Jekyll
+  class PackageCategoriesGenerator < Generator
+    def generate(site)
+      # Generate one file per category for the Packages sub-pages
+      site.data.dig('packages', 'packages', 'categories').each do |category|
+        category_page = PageWithoutAFile.new(site, site.source, "packages", "#{category['slug']}.md")
+        category_page.data = {
+          # Front matter
+          'layout' => 'page',
+          'title' => category['name']
+        }
+        category_page.content = "{% include_relative _package-list.html category_slug=\"#{category['slug']}\" %}"
+        site.pages << category_page
+      end
+    end
+  end
+end