Add Tools page

Author: federicobucchi

_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,24 @@
+- name: Xcode
+  description: Xcode helps improve your productivity by simplifying Swift development on macOS.
+  link: https://xcode.apple.com
+  officially-supported: true
+- name: Visual Studio Code
+  description: Visual Studio Code provides a modern development environment for Swift through the Swift extension.
+  link: https://code.visualstudio.com
+  guide: /documentation/articles/getting-started-with-vscode-swift.html
+  officially-supported: true
+- name: Emacs
+  description: Emacs provides a flexible and powerful environment for writing Swift code.
+  link: https://www.gnu.org/software/emacs/
+  community-supported: true
+  guide: /documentation/articles/zero-to-swift-emacs.html
+- name: Neovim
+  description: Neovim is a robust and adaptable editing environment that boosts productivity and efficiency for Swift development.
+  link: https://neovim.io/
+  guide: /documentation/articles/zero-to-swift-nvim.html
+  community-supported: true
+- name: Other Editors
+  description: Any editor that supports the Language Server Protocol (LSP) can use SourceKit-LSP to provide Swift support.
+  link: https://github.com/apple/sourcekit-lsp/tree/main/Editors#other-editors
+  officially-supported: true
+  guide: /documentation/articles/other-swift-editors.html

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,54 @@
+.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;
+    }
+
+    .supported {
+      display: inline-flex;
+      align-items: center;
+      justify-content: center;
+      border-radius: 4px;
+      border: 1px #f05138 solid;
+      font-size: 12px;
+      line-height: 1;
+      white-space: nowrap;
+      color: #f05138;
+      padding: 4px 5px;
+
+      &.community {
+        border: 1px #3ea639 solid;
+        color: #3ea639;
+      }
+    }
+  }
+
+  @media (min-width: 1000px) {
+    grid-template-columns: repeat(2, 1fr);
+  }
+}

tools/_editors.md

@@ -0,0 +1,32 @@
+## Editors
+
+The listed text editors provide code completion and navigation, syntax highlighting, debugging, and build system integration enhancing code quality and productivity for Swift developers.
+
+<ul class="tool-list">
+  {%- for editor in site.data.tools.editors %}
+    <li class="tool">
+      <h3>
+        <a target="_blank" href="{{ editor.link }}">
+          {{ editor.name }}
+        </a>
+        {% if editor.officially-supported or editor.community-supported %}
+          <span class="supported {% if editor.community-supported %} community{% endif %}">
+            {% if editor.officially-supported %}
+              Officially supported
+            {% else %}
+              Community supported
+            {% endif %}
+          </span>
+        {% endif %}
+      </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
+---
+
+Developers can use Swift editing tools to create and maintain Swift code more efficiently, leading to better outcomes and higher-quality software applications.
+
+{% include_relative _editors.md %}