diff --git a/.github/dependabot.yml b/.github/dependabot.yml new file mode 100644 index 00000000..f1c529a9 --- /dev/null +++ b/.github/dependabot.yml @@ -0,0 +1,14 @@ +# Documentation for all configuration options: +# https://help.github.com/github/administering-a-repository/configuration-options-for-dependency-updates + +version: 2 +updates: + - package-ecosystem: "github-actions" + directory: "/" + schedule: + interval: "weekly" + + - package-ecosystem: bundler + directory: "/" + schedule: + interval: "weekly" diff --git a/.github/workflows/ci.yml b/.github/workflows/ci.yml new file mode 100644 index 00000000..ace64de2 --- /dev/null +++ b/.github/workflows/ci.yml @@ -0,0 +1,52 @@ +name: CI +env: + ACTIONS_ALLOW_UNSECURE_COMMANDS: true + +on: + push: + branches: + - main + pull_request: + branches: + - main + +jobs: + build: + name: Build Site + runs-on: macOS-latest + steps: + - name: git checkout + uses: actions/checkout@v2.4.0 + + - name: versions + run: | + ruby --version + gem --version + bundler --version + + - name: cache + uses: actions/cache@v3.0.2 + with: + path: vendor/bundle + key: ${{ runner.os }}-gem-${{ hashFiles('**/Gemfile.lock') }} + restore-keys: | + ${{ runner.os }}-gem- + + - name: bundle install + run: | + gem uninstall jekyll-commonmark-ghpages + bundle config path vendor/bundle + bundle install --without=documentation --jobs 4 --retry 3 + echo "::add-path::/Users/runner/Library/Python/2.7/bin" + + - name: jekyll build + run: bundle exec jekyll build + + - name: danger + # The API token required for Danger to post comments is not available in fork PRs, + # thus disabling Danger for such PRs. See this post for more details: + # https://github.community/t/make-secrets-available-to-builds-of-forks/16166 + if: github.event.pull_request.head.repo.full_name == github.repository + env: + DANGER_GITHUB_API_TOKEN: ${{ secrets.DANGER_GITHUB_API_TOKEN }} + run: bundle exec danger diff --git a/.gitignore b/.gitignore index 3da9b95d..1fc4b930 100644 --- a/.gitignore +++ b/.gitignore @@ -1,3 +1,4 @@ .DS_Store _site/ .jekyll-metadata +.Ulysses-Settings.plist diff --git a/.ruby-version b/.ruby-version new file mode 100644 index 00000000..fd2a0186 --- /dev/null +++ b/.ruby-version @@ -0,0 +1 @@ +3.1.0 diff --git a/.travis.yml b/.travis.yml deleted file mode 100644 index f6c009d3..00000000 --- a/.travis.yml +++ /dev/null @@ -1,6 +0,0 @@ -language: ruby - -rvm: - - 2.1.3 - -script: "bundle exec jekyll build" diff --git a/404.html b/404.html index 03a8614f..55d9a020 100644 --- a/404.html +++ b/404.html @@ -6,5 +6,7 @@

Oops! Something went wrong. Sorry!

+

404: Page not found

+
404
diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md deleted file mode 100644 index 624d2ce1..00000000 --- a/CONTRIBUTING.md +++ /dev/null @@ -1,49 +0,0 @@ -# Contributing to the Swift Weekly Brief - -*Contributions are welcome and encouraged!* :tada: - -### Translating :scroll: - -Interested in translating content? Great! [Open an issue][issueLink] to start the conversation. - -### Content Suggestions :memo: - -Something you want to share or have included in the newsletter? Please [open an issue][issueLink] and provide the following: - -- A link to the content -- A brief description -- An explanation of why this is important to include - -### Fixes or Corrections :bug: - -Please [open an issue][issueLink] or [submit a pull request][prLink]! - --------------------------------- - -## Contributing content directly - -*Would you like to contribute directly to the next issue? Awesome! Here's how to get started.* - -**Prerequisites:** you should have a good understanding of how [Jekyll](http://jekyllrb.com) and [GitHub-Pages](https://pages.github.com) work. - -:warning: Remember, we publish **every Thursday**. - -### Contributing to the next issue - -If you would like to contribute a thing or two to the next issue, it's easy! You can find the drafts for upcoming issues in the [`_drafts/`](https://github.com/SwiftWeekly/swiftweekly.github.io/tree/master/_drafts) directory. (Spoiler alert! :smile:) Add your content, then submit a [pull request][prLink]. - -### Writing a complete issue - -1. Add yourself under `authors:` in the `_config.yml` file. (If you haven't already.) - - Choose an author handle - - Provide your name - - Provide your url. This should be a `Twitter` or `GitHub` url. -2. Copy the provided [template](https://github.com/SwiftWeekly/swiftweekly.github.io/blob/master/template/YYYY-MM-DD-issue-N.md). Fill in the date, issue number, and author. (Don't forget to remove the `==TEMPLATE==` text at the beginning.) -3. Write your complete issue. Follow the example set by previous issues. -4. Make sure the `.md` file is in the `_posts/` directory. -5. Run `jekyll build` on your local copy to preview. -6. Submit a [pull request][prLink]. :tada: - - -[issueLink]:https://github.com/SwiftWeekly/swiftweekly.github.io/issues/new -[prLink]:https://github.com/SwiftWeekly/swiftweekly.github.io/compare diff --git a/Dangerfile b/Dangerfile new file mode 100644 index 00000000..33c79a0a --- /dev/null +++ b/Dangerfile @@ -0,0 +1,39 @@ + +# Reminders for writing a draft +is_adding_draft = !(git.added_files.grep(/_drafts/).empty?) +is_editing_draft = !(git.modified_files.grep(/_drafts/).empty?) +if is_editing_draft || is_adding_draft + editing_message = <<-EOS +Looks like you're editing a draft! 🤓 +**Don't forget** to review [our style guide](https://github.com/SwiftWeekly/swiftweekly.github.io/blob/main/CONTRIBUTING.md#-writing-style-guide) and [publish the issue](https://github.com/SwiftWeekly/swiftweekly.github.io/blob/main/CONTRIBUTING.md#-publishing-an-issue) when you're finished. + EOS + warn(editing_message) +end + +# Reminders for publishing an issue +is_publishing_issue = !(git.added_files.grep(/_posts/).empty?) +if is_publishing_issue + publish_message = <<-EOS +Looks like you're publishing a new issue! 🎉 +**Don't forget to:** +1. Review [our style guide](https://github.com/SwiftWeekly/swiftweekly.github.io/blob/main/CONTRIBUTING.md#-writing-style-guide) before merging +2. After you merge, close the GitHub issue notes for this newsletter issue +3. Open the next GitHub issue, add the correct labels, assign it to the next writer +4. Run the `new_draft.sh` script and push the next draft + EOS + warn(publish_message) +end + +# Check spelling and prose +prose.language = "en-us" +prose.ignore_acronyms = true +prose.ignore_numbers = true +prose.ignored_words = [ + "Swift", "iOS", "macOS", "watchOS", "tvOS", "iPhone", "iPad", "nonnull", "nullable", + "nullability", "corelibs-foundation", "corelibs-libdispatch", "stdlib", "GCD", "SwiftPM", + "Xcode", "TODO", "swift-evolution", "swift-package-manager", "swift-lldb", "swift-clang", + "swift-llvm", "swift-corelibs-foundation", "swift-corelibs-libdispatch", "ClangImporter", + "libdispatch", "XCTest", "SourceKit", "CMake", "SIL", "ABI", "llbuild", + "CoreFoundation", "Swift.org", "WWDC", "@objc" +] +prose.lint_files diff --git a/Gemfile b/Gemfile index 97355ea7..c8457296 100644 --- a/Gemfile +++ b/Gemfile @@ -1,3 +1,16 @@ source 'https://rubygems.org' gem 'github-pages' +gem 'jekyll-commonmark-ghpages' +gem 'jekyll-paginate' +gem 'jekyll-sitemap' +gem 'jekyll' + +gem 'danger' +gem 'danger-prose' + +gem 'claide' +gem 'octokit' +gem 'colorize' + +gem "webrick", "~> 1.7" diff --git a/Gemfile.lock b/Gemfile.lock index c0352d00..ffe448b9 100644 --- a/Gemfile.lock +++ b/Gemfile.lock @@ -1,129 +1,330 @@ GEM remote: https://rubygems.org/ specs: - RedCloth (4.2.9) - activesupport (4.2.5.1) - i18n (~> 0.7) - json (~> 1.7, >= 1.7.7) - minitest (~> 5.1) - thread_safe (~> 0.3, >= 0.3.4) - tzinfo (~> 1.1) - addressable (2.3.8) + activesupport (7.0.4.3) + concurrent-ruby (~> 1.0, >= 1.0.2) + i18n (>= 1.6, < 2) + minitest (>= 5.1) + tzinfo (~> 2.0) + addressable (2.8.1) + public_suffix (>= 2.0.2, < 6.0) + claide (1.1.0) + claide-plugins (0.9.2) + cork + nap + open4 (~> 1.3) coffee-script (2.4.1) coffee-script-source execjs - coffee-script-source (1.10.0) - colorator (0.1) - ethon (0.8.1) - ffi (>= 1.3.0) - execjs (2.6.0) - faraday (0.9.2) - multipart-post (>= 1.2, < 3) - ffi (1.9.10) - gemoji (2.1.0) - github-pages (45) - RedCloth (= 4.2.9) - github-pages-health-check (= 0.6.0) - jekyll (= 3.0.2) - jekyll-coffeescript (= 1.0.1) - jekyll-feed (= 0.3.1) - jekyll-gist (= 1.4.0) - jekyll-mentions (= 1.0.0) + coffee-script-source (1.11.1) + colorator (1.1.0) + colored2 (3.1.2) + colorize (0.8.1) + commonmarker (0.23.8) + concurrent-ruby (1.2.2) + cork (0.3.0) + colored2 (~> 3.1) + danger (8.6.1) + claide (~> 1.0) + claide-plugins (>= 0.9.2) + colored2 (~> 3.1) + cork (~> 0.1) + faraday (>= 0.9.0, < 2.0) + faraday-http-cache (~> 2.0) + git (~> 1.7) + kramdown (~> 2.3) + kramdown-parser-gfm (~> 1.0) + no_proxy_fix + octokit (~> 4.7) + terminal-table (>= 1, < 4) + danger-prose (2.0.7) + danger + dnsruby (1.61.9) + simpleidn (~> 0.1) + em-websocket (0.5.3) + eventmachine (>= 0.12.9) + http_parser.rb (~> 0) + ethon (0.16.0) + ffi (>= 1.15.0) + eventmachine (1.2.7) + execjs (2.8.1) + faraday (1.10.3) + faraday-em_http (~> 1.0) + faraday-em_synchrony (~> 1.0) + faraday-excon (~> 1.1) + faraday-httpclient (~> 1.0) + faraday-multipart (~> 1.0) + faraday-net_http (~> 1.0) + faraday-net_http_persistent (~> 1.0) + faraday-patron (~> 1.0) + faraday-rack (~> 1.0) + faraday-retry (~> 1.0) + ruby2_keywords (>= 0.0.4) + faraday-em_http (1.0.0) + faraday-em_synchrony (1.0.0) + faraday-excon (1.1.0) + faraday-http-cache (2.4.1) + faraday (>= 0.8) + faraday-httpclient (1.0.1) + faraday-multipart (1.0.4) + multipart-post (~> 2) + faraday-net_http (1.0.1) + faraday-net_http_persistent (1.2.0) + faraday-patron (1.0.0) + faraday-rack (1.0.0) + faraday-retry (1.0.3) + ffi (1.15.5) + forwardable-extended (2.6.0) + gemoji (3.0.1) + git (1.18.0) + addressable (~> 2.8) + rchardet (~> 1.8) + github-pages (228) + github-pages-health-check (= 1.17.9) + jekyll (= 3.9.3) + jekyll-avatar (= 0.7.0) + jekyll-coffeescript (= 1.1.1) + jekyll-commonmark-ghpages (= 0.4.0) + jekyll-default-layout (= 0.1.4) + jekyll-feed (= 0.15.1) + jekyll-gist (= 1.5.0) + jekyll-github-metadata (= 2.13.0) + jekyll-include-cache (= 0.2.1) + jekyll-mentions (= 1.6.0) + jekyll-optional-front-matter (= 0.3.2) jekyll-paginate (= 1.1.0) - jekyll-redirect-from (= 0.9.1) - jekyll-sass-converter (= 1.3.0) - jekyll-seo-tag (= 0.1.4) - jekyll-sitemap (= 0.10.0) - jekyll-textile-converter (= 0.1.0) - jemoji (= 0.5.1) - kramdown (= 1.9.0) - liquid (= 3.0.6) + jekyll-readme-index (= 0.3.0) + jekyll-redirect-from (= 0.16.0) + jekyll-relative-links (= 0.6.1) + jekyll-remote-theme (= 0.4.3) + jekyll-sass-converter (= 1.5.2) + jekyll-seo-tag (= 2.8.0) + jekyll-sitemap (= 1.4.0) + jekyll-swiss (= 1.0.0) + jekyll-theme-architect (= 0.2.0) + jekyll-theme-cayman (= 0.2.0) + jekyll-theme-dinky (= 0.2.0) + jekyll-theme-hacker (= 0.2.0) + jekyll-theme-leap-day (= 0.2.0) + jekyll-theme-merlot (= 0.2.0) + jekyll-theme-midnight (= 0.2.0) + jekyll-theme-minimal (= 0.2.0) + jekyll-theme-modernist (= 0.2.0) + jekyll-theme-primer (= 0.6.0) + jekyll-theme-slate (= 0.2.0) + jekyll-theme-tactile (= 0.2.0) + jekyll-theme-time-machine (= 0.2.0) + jekyll-titles-from-headings (= 0.5.3) + jemoji (= 0.12.0) + kramdown (= 2.3.2) + kramdown-parser-gfm (= 1.1.0) + liquid (= 4.0.4) mercenary (~> 0.3) - rdiscount (= 2.1.8) - redcarpet (= 3.3.3) - rouge (= 1.10.1) + minima (= 2.5.1) + nokogiri (>= 1.13.6, < 2.0) + rouge (= 3.26.0) terminal-table (~> 1.4) - github-pages-health-check (0.6.0) + github-pages-health-check (1.17.9) addressable (~> 2.3) - net-dns (~> 0.8) - public_suffix (~> 1.4) - typhoeus (~> 0.7) - html-pipeline (2.3.0) - activesupport (>= 2, < 5) + dnsruby (~> 1.60) + octokit (~> 4.0) + public_suffix (>= 3.0, < 5.0) + typhoeus (~> 1.3) + html-pipeline (2.14.3) + activesupport (>= 2) nokogiri (>= 1.4) - i18n (0.7.0) - jekyll (3.0.2) - colorator (~> 0.1) + http_parser.rb (0.8.0) + i18n (1.12.0) + concurrent-ruby (~> 1.0) + jekyll (3.9.3) + addressable (~> 2.4) + colorator (~> 1.0) + em-websocket (~> 0.5) + i18n (>= 0.7, < 2) jekyll-sass-converter (~> 1.0) - jekyll-watch (~> 1.1) - kramdown (~> 1.3) - liquid (~> 3.0) + jekyll-watch (~> 2.0) + kramdown (>= 1.17, < 3) + liquid (~> 4.0) mercenary (~> 0.3.3) - rouge (~> 1.7) + pathutil (~> 0.9) + rouge (>= 1.7, < 4) safe_yaml (~> 1.0) - jekyll-coffeescript (1.0.1) + jekyll-avatar (0.7.0) + jekyll (>= 3.0, < 5.0) + jekyll-coffeescript (1.1.1) coffee-script (~> 2.2) - jekyll-feed (0.3.1) - jekyll-gist (1.4.0) - octokit (~> 4.2) - jekyll-mentions (1.0.0) - html-pipeline (~> 2.2) + coffee-script-source (~> 1.11.1) + jekyll-commonmark (1.4.0) + commonmarker (~> 0.22) + jekyll-commonmark-ghpages (0.4.0) + commonmarker (~> 0.23.7) + jekyll (~> 3.9.0) + jekyll-commonmark (~> 1.4.0) + rouge (>= 2.0, < 5.0) + jekyll-default-layout (0.1.4) jekyll (~> 3.0) + jekyll-feed (0.15.1) + jekyll (>= 3.7, < 5.0) + jekyll-gist (1.5.0) + octokit (~> 4.2) + jekyll-github-metadata (2.13.0) + jekyll (>= 3.4, < 5.0) + octokit (~> 4.0, != 4.4.0) + jekyll-include-cache (0.2.1) + jekyll (>= 3.7, < 5.0) + jekyll-mentions (1.6.0) + html-pipeline (~> 2.3) + jekyll (>= 3.7, < 5.0) + jekyll-optional-front-matter (0.3.2) + jekyll (>= 3.0, < 5.0) jekyll-paginate (1.1.0) - jekyll-redirect-from (0.9.1) - jekyll (>= 2.0) - jekyll-sass-converter (1.3.0) - sass (~> 3.2) - jekyll-seo-tag (0.1.4) - jekyll (>= 2.0) - jekyll-sitemap (0.10.0) - jekyll-textile-converter (0.1.0) - RedCloth (~> 4.0) - jekyll-watch (1.3.1) + jekyll-readme-index (0.3.0) + jekyll (>= 3.0, < 5.0) + jekyll-redirect-from (0.16.0) + jekyll (>= 3.3, < 5.0) + jekyll-relative-links (0.6.1) + jekyll (>= 3.3, < 5.0) + jekyll-remote-theme (0.4.3) + addressable (~> 2.0) + jekyll (>= 3.5, < 5.0) + jekyll-sass-converter (>= 1.0, <= 3.0.0, != 2.0.0) + rubyzip (>= 1.3.0, < 3.0) + jekyll-sass-converter (1.5.2) + sass (~> 3.4) + jekyll-seo-tag (2.8.0) + jekyll (>= 3.8, < 5.0) + jekyll-sitemap (1.4.0) + jekyll (>= 3.7, < 5.0) + jekyll-swiss (1.0.0) + jekyll-theme-architect (0.2.0) + jekyll (> 3.5, < 5.0) + jekyll-seo-tag (~> 2.0) + jekyll-theme-cayman (0.2.0) + jekyll (> 3.5, < 5.0) + jekyll-seo-tag (~> 2.0) + jekyll-theme-dinky (0.2.0) + jekyll (> 3.5, < 5.0) + jekyll-seo-tag (~> 2.0) + jekyll-theme-hacker (0.2.0) + jekyll (> 3.5, < 5.0) + jekyll-seo-tag (~> 2.0) + jekyll-theme-leap-day (0.2.0) + jekyll (> 3.5, < 5.0) + jekyll-seo-tag (~> 2.0) + jekyll-theme-merlot (0.2.0) + jekyll (> 3.5, < 5.0) + jekyll-seo-tag (~> 2.0) + jekyll-theme-midnight (0.2.0) + jekyll (> 3.5, < 5.0) + jekyll-seo-tag (~> 2.0) + jekyll-theme-minimal (0.2.0) + jekyll (> 3.5, < 5.0) + jekyll-seo-tag (~> 2.0) + jekyll-theme-modernist (0.2.0) + jekyll (> 3.5, < 5.0) + jekyll-seo-tag (~> 2.0) + jekyll-theme-primer (0.6.0) + jekyll (> 3.5, < 5.0) + jekyll-github-metadata (~> 2.9) + jekyll-seo-tag (~> 2.0) + jekyll-theme-slate (0.2.0) + jekyll (> 3.5, < 5.0) + jekyll-seo-tag (~> 2.0) + jekyll-theme-tactile (0.2.0) + jekyll (> 3.5, < 5.0) + jekyll-seo-tag (~> 2.0) + jekyll-theme-time-machine (0.2.0) + jekyll (> 3.5, < 5.0) + jekyll-seo-tag (~> 2.0) + jekyll-titles-from-headings (0.5.3) + jekyll (>= 3.3, < 5.0) + jekyll-watch (2.2.1) listen (~> 3.0) - jemoji (0.5.1) - gemoji (~> 2.0) + jemoji (0.12.0) + gemoji (~> 3.0) html-pipeline (~> 2.2) - jekyll (>= 2.0) - json (1.8.3) - kramdown (1.9.0) - liquid (3.0.6) - listen (3.0.5) - rb-fsevent (>= 0.9.3) - rb-inotify (>= 0.9) - mercenary (0.3.5) - mini_portile2 (2.0.0) - minitest (5.8.4) - multipart-post (2.0.0) - net-dns (0.8.0) - nokogiri (1.6.7.2) - mini_portile2 (~> 2.0.0.rc2) - octokit (4.2.0) - sawyer (~> 0.6.0, >= 0.5.3) - public_suffix (1.5.3) - rb-fsevent (0.9.7) - rb-inotify (0.9.5) - ffi (>= 0.5.0) - rdiscount (2.1.8) - redcarpet (3.3.3) - rouge (1.10.1) - safe_yaml (1.0.4) - sass (3.4.21) - sawyer (0.6.0) - addressable (~> 2.3.5) - faraday (~> 0.8, < 0.10) - terminal-table (1.5.2) - thread_safe (0.3.5) - typhoeus (0.8.0) - ethon (>= 0.8.0) - tzinfo (1.2.2) - thread_safe (~> 0.1) + jekyll (>= 3.0, < 5.0) + kramdown (2.3.2) + rexml + kramdown-parser-gfm (1.1.0) + kramdown (~> 2.0) + liquid (4.0.4) + listen (3.8.0) + rb-fsevent (~> 0.10, >= 0.10.3) + rb-inotify (~> 0.9, >= 0.9.10) + mercenary (0.3.6) + mini_portile2 (2.8.1) + minima (2.5.1) + jekyll (>= 3.5, < 5.0) + jekyll-feed (~> 0.9) + jekyll-seo-tag (~> 2.1) + minitest (5.18.0) + multipart-post (2.3.0) + nap (1.1.0) + no_proxy_fix (0.1.2) + nokogiri (1.14.2) + mini_portile2 (~> 2.8.0) + racc (~> 1.4) + nokogiri (1.14.2-arm64-darwin) + racc (~> 1.4) + nokogiri (1.14.2-x86_64-darwin) + racc (~> 1.4) + octokit (4.25.1) + faraday (>= 1, < 3) + sawyer (~> 0.9) + open4 (1.3.4) + pathutil (0.16.2) + forwardable-extended (~> 2.6) + public_suffix (4.0.7) + racc (1.6.2) + rb-fsevent (0.11.2) + rb-inotify (0.10.1) + ffi (~> 1.0) + rchardet (1.8.0) + rexml (3.2.5) + rouge (3.26.0) + ruby2_keywords (0.0.5) + rubyzip (2.3.2) + safe_yaml (1.0.5) + sass (3.7.4) + sass-listen (~> 4.0.0) + sass-listen (4.0.0) + rb-fsevent (~> 0.9, >= 0.9.4) + rb-inotify (~> 0.9, >= 0.9.7) + sawyer (0.9.2) + addressable (>= 2.3.5) + faraday (>= 0.17.3, < 3) + simpleidn (0.2.1) + unf (~> 0.1.4) + terminal-table (1.8.0) + unicode-display_width (~> 1.1, >= 1.1.1) + typhoeus (1.4.0) + ethon (>= 0.9.0) + tzinfo (2.0.6) + concurrent-ruby (~> 1.0) + unf (0.1.4) + unf_ext + unf_ext (0.0.8.2) + unicode-display_width (1.8.0) + webrick (1.8.1) PLATFORMS ruby + universal-darwin-20 + x86_64-darwin-19 DEPENDENCIES + claide + colorize + danger + danger-prose github-pages + jekyll + jekyll-commonmark-ghpages + jekyll-paginate + jekyll-sitemap + octokit + webrick (~> 1.7) BUNDLED WITH - 1.11.2 + 2.4.9 diff --git a/README.md b/README.md index 4537637f..1457c988 100644 --- a/README.md +++ b/README.md @@ -1,22 +1,24 @@ -# [swiftweekly.github.io](https://swiftweekly.github.io) [![Build Status](https://travis-ci.org/SwiftWeekly/swiftweekly.github.io.svg?branch=master)](https://travis-ci.org/SwiftWeekly/swiftweekly.github.io) +# [swiftweekly.github.io](https://swiftweekly.github.io) ![CI](https://github.com/swiftweekly/swiftweekly.github.io/workflows/CI/badge.svg) *A community-driven weekly newsletter about [Swift.org](https://swift.org)* -> Curated by [@jesse_squires](https://twitter.com/jesse_squires). -> ->[**Subscribe**](http://swiftweekly.github.io/subscribe/) to get the best summary about what's happening in the Swift open source project every week. +> Started by [@jesse_squires](https://twitter.com/jesse_squires), continued by [@BasThomas](https://twitter.com/BasThomas) and now curated by [@fassko](https://twitter.com/fassko). - + ## About -This newsletter was originally started by [Jesse Squires](https://github.com/jessesquires), and hosted on his blog at [jessesquires.com](http://www.jessesquires.com). After issue #4, this site was created to provide the newsletter with a proper, dedicated home. All previous issues were [migrated](http://www.jessesquires.com/new-weekly-brief/), and it is now completely open for the community. Contributions are welcomed and encouraged! +This newsletter was originally started by [Jesse Squires](https://github.com/jessesquires), and hosted on his blog at [jessesquires.com](http://www.jessesquires.com). After issue #4, this site was created to provide the newsletter with a proper, dedicated home. All previous issues were [migrated](http://www.jessesquires.com/new-weekly-brief/), and it is now completely open for the community. At some point, [Bas Broek](https://twitter.com/BasThomas) took it over as the main contributor. Currently, [Kristaps Grinbergs](https://github.com/fassko) is leading the project. Contributions are welcomed and encouraged! Lovingly built with [Jekyll](https://jekyllrb.com), [Bootstrap](https://getbootstrap.com), [jQuery](https://jquery.com), and [Font Awesome](https://fortawesome.github.io/Font-Awesome/). Generously hosted by [GitHub](https://pages.github.com). +## Authors + +There are a number of [contributing authors](https://swiftweeklybrief.com/authors/) to the newsletter. If you'd like to join, open an issue to discuss! + ## Usage -#### Installation +### Installation You'll need [bundler](http://bundler.io) installed. @@ -26,22 +28,33 @@ $ cd swiftweekly.github.io/ $ bundle install ``` -#### Building the site +### Building the site ```bash $ bundle exec jekyll build ``` -#### Previewing the site locally +### Previewing the site locally ```bash -$ bundle exec jekyll serve +$ bundle exec jekyll serve +# Now browse to http://localhost:4000 +``` + +### Writing and previewing drafts + +```bash +$ bundle exec jekyll serve --future --drafts --watch # Now browse to http://localhost:4000 ``` ## Contributing -For translations, content suggestions, fixes, or corrections — please see [`CONTRIBUTING.md`](https://github.com/SwiftWeekly/swiftweekly.github.io/blob/master/CONTRIBUTING.md). +To contribute, please review our [Contributing Guide](https://github.com/SwiftWeekly/.github/blob/master/CONTRIBUTING.md). + +## Conduct + +Please read our [Code of Conduct](https://github.com/SwiftWeekly/.github/blob/master/CODE_OF_CONDUCT.md). Violations will not be tolerated and will result in immediate removal or blocking from the organization. ## License diff --git a/_config.yml b/_config.yml index c5790b1f..6854c1f0 100644 --- a/_config.yml +++ b/_config.yml @@ -2,36 +2,40 @@ markdown: kramdown highlighter: rouge -gems: - - jekyll-sitemap +plugins: + - jekyll-sitemap + - jekyll-paginate -exclude: [vendor] +# File rules +exclude: [vendor, Dangerfile, Gemfile, Gemfile.lock, LICENSE, README.md, CODE_OF_CONDUCT.md, CONTRIBUTING.md, new_draft.sh, github_issue_generator.rb] # Permalinks permalink: /:title/ -# Setup +# Site title: 'Swift Weekly Brief' -tagline: 'A community-driven weekly newsletter about Swift.org' +description: 'A community-driven weekly newsletter about Swift.org' +url: https://swiftweeklybrief.com +logo: /img/logo.png timezone: America/Los_Angeles -url: https://swiftweekly.github.io -handle: '@swiftlybrief' +repo_name: swiftweekly.github.io -author: - name: 'Jesse Squires' - url: https://twitter.com/jesse_squires +twitter: + username: swiftlybrief +# Setup excerpt_separator: +# Data links: - twitter: 'https://twitter.com/swiftlybrief' - github: 'https://github.com/SwiftWeekly/swiftweekly.github.io' - issue: 'https://github.com/SwiftWeekly/swiftweekly.github.io/issues/new' - pull: 'https://github.com/SwiftWeekly/swiftweekly.github.io/compare' - -authors: - jsq: - name: 'Jesse Squires' - twitter: '@jesse_squires' - url: 'https://twitter.com/jesse_squires' + rss: '/feed.xml' + twitter: 'https://twitter.com/swiftlybrief' + github: 'https://github.com/SwiftWeekly/swiftweekly.github.io' + issue: 'https://github.com/SwiftWeekly/swiftweekly.github.io/issues/new' + pull: 'https://github.com/SwiftWeekly/swiftweekly.github.io/compare' + applenews: 'https://apple.news/TIlGIYluMTGWA-CIToVtF4Q' + + +paginate: 25 +paginate_path: "/page:num/" \ No newline at end of file diff --git a/_data/authors.yml b/_data/authors.yml new file mode 100644 index 00000000..a9e4ce2d --- /dev/null +++ b/_data/authors.yml @@ -0,0 +1,44 @@ +jsq: + name: 'Jesse Squires' + twitter: jesse_squires + github: jessesquires +modocache: + name: 'Brian Gesiak' + twitter: modocache + github: modocache +jpsim: + name: 'JP Simard' + twitter: simjp + github: jpsim +btb: + name: 'Bas Broek' + twitter: BasThomas + github: BasThomas +gregheo: + name: 'Greg Heo' + twitter: gregheo + github: gregheo +basher: + name: 'Ben Asher' + twitter: benasher44 + github: benasher44 +garric: + name: 'Garric Nahapetian' + twitter: garricn + github: garricn +roman: + name: 'Roman Volkov' + twitter: volkovre + github: RomanVolkov +tapthaker: + name: 'Tapan Thaker' + twitter: tapthaker + github: tapthaker +fassko: + name: 'Kristaps Grinbergs' + twitter: fassko + github: fassko +appforce1: + name: 'Jeroen Leenarts' + twitter: appforce1 + github: appforce1 diff --git a/_drafts/2016-03-31-issue-16.md b/_drafts/2016-03-31-issue-16.md deleted file mode 100644 index 3a946bb7..00000000 --- a/_drafts/2016-03-31-issue-16.md +++ /dev/null @@ -1,31 +0,0 @@ ---- -layout: post -title: ! 'Issue #16' -author: jsq ---- - -> TODO - - - -### Starter tasks - -> TODO - -{% include task_remind.html %} - -### Commits and pull requests - -> TODO - -### Proposals - -> TODO - -### Mailing lists - -> TODO - -### Finally - -> TODO diff --git a/_includes/foot.html b/_includes/foot.html index c3f5795d..f6c4fc0f 100644 --- a/_includes/foot.html +++ b/_includes/foot.html @@ -1,7 +1,7 @@ - + - + diff --git a/_includes/footer.html b/_includes/footer.html index 47a96b35..3c60377e 100644 --- a/_includes/footer.html +++ b/_includes/footer.html @@ -1,24 +1,33 @@ -