Add Tools page

_data/navigation.yml

@@ -10,6 +10,9 @@
 - header: Packages
   url: /packages/
 # ------------------------------------------------------------------------------
+- header: Tools
+  url: /tools/
+# ------------------------------------------------------------------------------
 - header: Community
   url: /community/
   pages:

_data/tools/editors.yml

@@ -0,0 +1,20 @@
+- name: Xcode
+  description: Xcode is a complete IDE enabling you to develop, test, debug, and distribute apps for all Apple platforms on macOS.
+  link: https://developer.apple.com/xcode
+  guide: https://developer.apple.com/xcode
+- name: Visual Studio Code
+  description: Visual Studio Code is a cross-platform and extensible editor that supports Swift through the Swift extension, which provides intelligent editor functionality as well as debugging and test support.
+  link: https://code.visualstudio.com
+  guide: /documentation/articles/getting-started-with-vscode-swift.html
+- name: Emacs
+  description: Emacs is an extensible cross-platform text editor. Swift editing support can be enabled through community-provided packages.
+  link: https://www.gnu.org/software/emacs/
+  guide: /documentation/articles/zero-to-swift-emacs.html
+- name: Neovim
+  description: Neovim is an extensible cross-platform text editor. Swift editing support can be enabled through your pick of community-provided plugins.
+  link: https://neovim.io/
+  guide: /documentation/articles/zero-to-swift-nvim.html
+- name: Other Editors
+  description: Any editor that supports the Language Server Protocol (LSP) can use SourceKit-LSP to provide intelligent editor functionality for Swift.
+  link: https://github.com/apple/sourcekit-lsp/tree/main/Documentation/Editor%20Integration.md
+  guide: https://github.com/apple/sourcekit-lsp/tree/main/Documentation/Editor%20Integration.md

assets/stylesheets/_pages.scss

@@ -3,3 +3,4 @@
 @import "pages/swift-evolution";
 @import "pages/packages";
 @import "pages/download";
+@import "pages/tools";

assets/stylesheets/pages/_tools.scss

@@ -0,0 +1,36 @@
+.tool-list {
+  $grid-breakpoint: 1000px;
+  list-style: none;
+  padding-left: 0;
+  display: grid;
+  gap: 1rem;
+
+  .tool {
+    border: 1px solid var(--color-fill-tertiary);
+    padding: 1rem;
+    border-radius: 4px;
+    display: flex;
+    flex-direction: column;
+
+    h3 {
+      line-height: 1.4;
+      font-size: 1.4rem;
+      padding-top: 0;
+      display: flex;
+      justify-content: space-between;
+    }
+
+    p {
+      flex-grow: 1;
+      color: var(--color-secondary-label);
+    }
+
+    img {
+      width: 26px;
+    }
+  }
+
+  @media (min-width: 1000px) {
+    grid-template-columns: repeat(2, 1fr);
+  }
+}

tools/_editors.md

@@ -0,0 +1,21 @@
+## Editors
+
+<ul class="tool-list">
+  {%- for editor in site.data.tools.editors %}
+    <li class="tool">
+      <h3>
+        <a target="_blank" href="{{ editor.link }}">
+          {{ editor.name }}
+        </a>
+      </h3>
+      <p class="description">
+        {{ editor.description }}
+      </p>
+      {% if editor.guide %}
+        <a href="{{ editor.guide }}" class="cta-secondary">
+          Learn more
+        </a>
+      {% endif %}
+    </li>
+  {%- endfor %}
+</ul>

tools/index.md

@@ -0,0 +1,8 @@
+---
+layout: page-wide
+title: Tools
+---
+
+Your favorite editor likely already supports Swift. Below are setup guides for some popular choices.
+
+{% include_relative _editors.md %}