From 264f17ae9f1075fe543212a4e8abacd5752007b1 Mon Sep 17 00:00:00 2001 From: Takuya N Date: Mon, 2 Jan 2023 22:48:27 +0900 Subject: [PATCH] Rewrite about from HAML to Markdown (#1047) Signed-off-by: Takuya Noguchi --- source/localizable/about.en.html.haml | 73 --------------------------- source/localizable/about.en.html.md | 49 ++++++++++++++++++ 2 files changed, 49 insertions(+), 73 deletions(-) delete mode 100644 source/localizable/about.en.html.haml create mode 100644 source/localizable/about.en.html.md diff --git a/source/localizable/about.en.html.haml b/source/localizable/about.en.html.haml deleted file mode 100644 index 4a884b186d..0000000000 --- a/source/localizable/about.en.html.haml +++ /dev/null @@ -1,73 +0,0 @@ ---- -title: About this site -layout: two_column_layout ---- -.container - .row.my-5 - %h1 - About this Web site - %h2 - Source code - %p - = link_to "https://github.com/rubygems/bundler-site", "https://github.com/rubygems/bundler-site" - - %h2 - Architecture - %p - Middleman 4.4 is the core system of this Web site. - A half of source code is located in - %code ./source - , but the other half is located in - = succeed "," do - = link_to "rubygems/rubygems/tree/master/bundler/lib/bundler/man" , "https://github.com/rubygems/rubygems/tree/master/bundler/lib/bundler/man" - which would be retrieved by executing - %code bundle exec rake man - \. - %p - When the source code is merged to the default branch - %code master - on GitHub, - = link_to "Deploy job on GitHub Actions", "https://github.com/rubygems/bundler-site/blob/HEAD/.github/workflows/deploy.yml" - would automatically build source (HTML, JS, CSS and font) and push them to GitHub Pages. - Deploy status can be followed in - = succeed "." do - = link_to "github-pages Deployment history", "https://github.com/rubygems/bundler-site/deployments/activity_log?environment=github-pages" - Custom domain is used to host `bundler.io` (see also - = succeed ")." do - -# haml-lint:disable LineLength - = link_to "Managing a custom domain for your GitHub Pages site", "https://docs.github.com/en/pages/configuring-a-custom-domain-for-your-github-pages-site/managing-a-custom-domain-for-your-github-pages-site#configuring-a-subdomain" - -# haml-lint:enable LineLength - %p - As seen above, you might sometimes take care about the difference in - deploy methods between review apps and production. Unlike production - mentioned above, review apps of this Web site rely on Heroku architecture, - which run as middleman server. - - %h2 - Localization - %p - While - = succeed "," do - = link_to "internationalization system was introduced in 2016", "/blog/2016/07/10/bundler-1-13-and-redesigned-bundler-io.html" - multilingualization is still ongoing. - - We welcome multilingualize more guides and other documentations. - To get started, move some files existing in - %code /source - or create a file to - %code /source/localizable - to multiligualize - files. - - %h2 - Becoming a maintainer of this Web site (namely - = succeed ")" do - %code rubygems/bundler-site - %p - If you want to be an official maintainer, start by helping out. - %p - As a first step, we welcome you to create a few of pull requests to improve - the Web site to - = succeed "." do - = link_to "the repo", "https://github.com/rubygems/bundler-site/pulls" - Also new feature improvement proposals are welcome. diff --git a/source/localizable/about.en.html.md b/source/localizable/about.en.html.md new file mode 100644 index 0000000000..159dbc416a --- /dev/null +++ b/source/localizable/about.en.html.md @@ -0,0 +1,49 @@ +--- +title: About this site +layout: two_column_layout +--- + +# About this Web site + +## Source code + +[https://github.com/rubygems/bundler-site](https://github.com/rubygems/bundler-site) + +## Architecture + +Middleman 4.4 is the core system of this Web site. +A half of source code is located in `./source`, +but the other half is located in [rubygems/rubygems/tree/master/bundler/lib/bundler/man"](https://github.com/rubygems/rubygems/tree/master/bundler/lib/bundler/man), +which would be retrieved by executing `bundle exec rake man`. + +When the source code is merged to the default branch `master` on GitHub, +[Deploy job on GitHub Actions](https://github.com/rubygems/bundler-site/blob/HEAD/.github/workflows/deploy.yml) +would automatically build source (HTML, JS, CSS and font) and push them to GitHub Pages. +Deploy status can be followed in +[github-pages Deployment history](https://github.com/rubygems/bundler-site/deployments/activity_log?environment=github-pages). +Custom domain is used to host `bundler.io` (see also +[Managing a custom domain for your GitHub Pages site](https://docs.github.com/en/pages/configuring-a-custom-domain-for-your-github-pages-site/managing-a-custom-domain-for-your-github-pages-site#configuring-a-subdomain)). + +As seen above, you might sometimes take care about the difference in +deploy methods between review apps and production. Unlike production +mentioned above, review apps of this Web site rely on Heroku architecture, +which run as middleman server. + +## Localization + +While +[internationalization system was introduced in 2016](/blog/2016/07/10/bundler-1-13-and-redesigned-bundler-io.html), +multilingualization is still ongoing. +We welcome multilingualize more guides and other documentations. +To get started, move some files existing in `/source` +or create a file to `/source/localizable` +to multiligualize +files. + +## Becoming a maintainer of this Web site (namely `rubygems/bundler-site`) + +If you want to be an official maintainer, start by helping out. + +As a first step, we welcome you to create a few of pull requests to improve +the Web site to [the repo](https://github.com/rubygems/bundler-site/pulls). +Also new feature improvement proposals are welcome.