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

@@ -2,3 +2,4 @@
 @import "pages/getting-started";
 @import "pages/swift-evolution";
 @import "pages/packages";
+@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 following text editors provide features such as code completion, syntax highlighting, code navigation, debugging capabilities, and integration with build systems. These features streamline the coding process, improve code quality, enhance productivity, and help developers write Swift code more effectively.
+
+<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
+---
+
+Swift editing tools provide developers with a structured and productive environment for creating, editing, and maintaining Swift code. By utilizing these tools, developers can work more efficiently on Swift projects, leading to better outcomes and higher-quality software applications.
+
+{% include_relative _editors.md %}