diff --git a/Gemfile b/Gemfile
deleted file mode 100644
index f64cbfc..0000000
--- a/Gemfile
+++ /dev/null
@@ -1,44 +0,0 @@
-source "https://rubygems.org"
-
-# Hello! This is where you manage which Jekyll version is used to run.
-# When you want to use a different version, change it below, save the
-# file and run `bundle install`. Run Jekyll with `bundle exec`, like so:
-#
-# bundle exec jekyll serve
-#
-# This will help ensure the proper Jekyll version is running.
-# Happy Jekylling!
-gem "jekyll"
-
-# This is the default theme for new Jekyll sites. You may change this to anything you like.
-
-# If you want to use GitHub Pages, remove the "gem "jekyll"" above and
-# uncomment the line below. To upgrade, run `bundle update github-pages`.
-# gem "github-pages", group: :jekyll_plugins
-gem "jekyll-theme-open-project"
-# gem "jekyll-theme-open-project", path: "~/src/jekyll-theme-open-project"
-
-# If you have any plugins, put them here!
-group :jekyll_plugins do
- gem "jekyll-seo-tag"
- gem "jekyll-sitemap"
- gem "jekyll-data"
- gem "jekyll-asciidoc"
- gem "jekyll-redirect-from"
- gem "git"
- gem "jekyll-theme-open-project-helpers"
- gem "kramdown-parser-gfm"
- gem "kramdown-syntax-coderay"
-end
-
-# Windows does not include zoneinfo files, so bundle the tzinfo-data gem
-gem "tzinfo-data", platforms: [:mingw, :mswin, :x64_mingw, :jruby]
-
-# Performance-booster for watching directories on Windows
-gem "wdm", "~> 0.1.0" if Gem.win_platform?
-
-# For testing generated HTML pages and links
-gem "rake"
-gem "html-proofer"
-
-gem "webrick", "~> 1.7"
diff --git a/LICENSE b/LICENSE
index 219f170..dd4b77e 100644
--- a/LICENSE
+++ b/LICENSE
@@ -1,6 +1,6 @@
MIT License
-Copyright (c) 2018 Ribose
+Copyright (c) 2023 Ribose
Permission is hereby granted, free of charge, to any person obtaining a copy
of this software and associated documentation files (the "Software"), to deal
@@ -18,4 +18,4 @@ FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
-SOFTWARE.
+SOFTWARE.
\ No newline at end of file
diff --git a/Makefile b/Makefile
deleted file mode 100644
index acf62d2..0000000
--- a/Makefile
+++ /dev/null
@@ -1,18 +0,0 @@
-SHELL := /bin/bash
-
-all: _site
-
-clean:
- bundle exec jekyll clean
- rm -rf _site _software/*/.git _software/*/docs _software/*/_*_repo _specs/fontist-model-diagrams parent-hub
-
-bundle:
- bundle
-
-_site:
- bundle exec jekyll build --trace
-
-serve:
- bundle exec jekyll serve --trace
-
-.PHONY: bundle all open serve clean
diff --git a/README.adoc b/README.adoc
deleted file mode 100644
index 32cc1e1..0000000
--- a/README.adoc
+++ /dev/null
@@ -1,34 +0,0 @@
-= Fontist Open Project Site
-
-== Introduction
-
-This is the Fontist project site, part of Ribose Open Project network, located
-at https://www.fontist.org.
-
-It is a https://jekyllrb.com[Jekyll]-based site created with the Open Project
-Jekyll theme.
-
-Refer to their respective docs for details.
-
-
-== Content management
-
-== Development
-
-=== Getting started
-
-* Ensure you have reasonable Ruby version
-* Run `bundle` from within site directory to install Ruby dependencies
-
-=== Serving site preview
-
-* Run `jekyll serve` from within site directory
-
-
-== Workflow
-
-. Ensure tests pass
-. Create your feature branch (`git checkout -b my-new-feature`)
-. Commit your changes (`git commit -am 'Add some feature'`)
-. Push to the branch (`git push origin my-new-feature`)
-. Make a pull request
diff --git a/README.md b/README.md
new file mode 100644
index 0000000..334f6fd
--- /dev/null
+++ b/README.md
@@ -0,0 +1,17 @@
+
+
+## Development
+
+![Vite](https://img.shields.io/static/v1?style=for-the-badge&message=Vite&color=646CFF&logo=Vite&logoColor=FFFFFF&label=)
+![Vue.js](https://img.shields.io/static/v1?style=for-the-badge&message=Vue.js&color=222222&logo=Vue.js&logoColor=4FC08D&label=)
+![Markdown](https://img.shields.io/static/v1?style=for-the-badge&message=Markdown&color=000000&logo=Markdown&logoColor=FFFFFF&label=)
+
+[![Open in Codeflow](https://developer.stackblitz.com/img/open_in_codeflow.svg)](https://pr.new/https://github.com/fontist/fontist.github.io)
+
+This site uses [VitePress](https://vitepress.dev/) as a static site generator. The website is hosted through GitHub Pages. There are sub-sites hosted from other GitHub [@fontist](https://github.com/fontist) repositories such as [fontist/fontist](https://github.com/fontist/fontist) which hosts [fontist.org/fontist](https://fontist.org/fontist/).
+
+๐ก Try to keeps this root website about the organization as a whole and redirect or point to other project-specific sub-sites where appropriate.
+
+๐ To create a new blog post you need to 1) create a new `.md` file in the `blog/` folder and 2) add it to the `blog/index.md` index page.
diff --git a/Rakefile b/Rakefile
deleted file mode 100644
index f474433..0000000
--- a/Rakefile
+++ /dev/null
@@ -1,86 +0,0 @@
-require 'html-proofer'
-
-$sourceDir = "./source"
-$outputDir = "./_site"
-$testOpts = {
- allow_hash_href: true,
- assume_extension: true
-}
-
-hostname = ENV['SITE_HOSTNAME']
-region = ENV['SITE_REGION']
-
-task :default => ["serve:development"]
-
-desc "cleans the output directory"
-task :clean do
- sh "jekyll clean"
-end
-
-namespace :deploy do
-
- desc "upload to S3"
- task :s3upload => [] do
- bucket = `aws s3api list-buckets --query "Buckets[?contains(Name, '#{hostname}')] | [0].Name" | jq -r '.'`
-
- p "Uploading to #{bucket} in #{region}"
-
- htmls = File.join("**", "*.html")
-
- # Remove extension from HTML files
- Dir.glob(htmls, base: "_site") do |filename|
- # Skip index.html
- next if filename == "index.html"
-
- filename_noext = filename.sub('.html', '')
- p "Will move #{filename} to #{filename_noext}"
- FileUtils.mv(filename, filename_noext)
- end
-
- p "Will upload non-HTML files"
- sh %{
- aws s3 sync _site/ s3://#{bucket} --region #{region} --delete \
- --size-only --exclude "*" --include "*.*"
- }
-
- p "Will upload HTML files"
- sh %{
- aws s3 sync _site/ s3://#{bucket} --region #{region} --delete \
- --content-type "text/html; charset=utf-8" --exclude "*.*"
- }
- end
-end
-
-namespace :build do
-
- desc "build development site"
- task :development => [:clean] do
- sh "jekyll build --drafts"
- end
-
- desc "build production site"
- task :production => [:clean] do
- sh "JEKYLL_ENV=production jekyll build --config=_config.yml"
- end
-end
-
-namespace :serve do
-
- desc "serve development site"
- task :development => [:clean] do
- sh "jekyll serve --drafts"
- end
-
- desc "serve production site"
- task :production => [:clean] do
- sh "JEKYLL_ENV=production jekyll serve --config=_config.yml"
- end
-end
-
-namespace :test do
-
- desc "test production build"
- task :production => ["build:production"] do
- HTMLProofer.check_directory($outputDir, $testOpts).run
- end
-end
diff --git a/_config.yml b/_config.yml
deleted file mode 100644
index da20211..0000000
--- a/_config.yml
+++ /dev/null
@@ -1,120 +0,0 @@
-title: Fontist
-description: Cross-platform font installer for Windows, Linux and macOS
-# The above two are used by jekyll-seo-tag for things such as
-# `` and `` tags, as well as elsewhere by the theme.
-
-permalink: /blog/:year-:month-:day-:title/
-
-url: https://www.fontist.org
-github_repo_url: https://github.com/fontist/fontist.org
-github_repo_branch: main
-
-algolia_search:
- api_key: '31ca4bad475130bdaee582a0b9f40806'
- index_name: 'fontist'
-
-tagline: >-
- Cross-platform font installer for
- Windows, Linux and macOS
-
-landing_priority: [custom_intro, blog, specs, software]
-
-theme: jekyll-theme-open-project
-
-author:
- name: Ribose Inc.
- url: https://www.ribose.com
-
-authors:
- - name: Ribose Inc.
- email: open.source@ribose.com
-
-contact_email: open.source@ribose.com
-
-theme: jekyll-theme-open-project
-
-parent_hub:
- git_repo_url: https://github.com/riboseinc/open.ribose.com
- git_repo_branch: main
- home_url: https://open.ribose.com/
-
-includes_dir: '.'
-
-social:
- links:
- - https://twitter.com/RiboseUS
- - https://github.com/fontist/fontist
-
-legal:
- name: Ribose Group Inc.
- tos_link: https://www.ribose.com/tos
- privacy_policy_link: https://www.ribose.com/privacy
-
-home_calls_to_action:
- - { url: "/software/fontist/docs/README/", title: "Using the gem" }
- #- { url: "/software/fontist-cli/docs/README/", title: "Using the CLI" }
-
-collections:
- projects:
- output: false
- software:
- output: true
- permalink: /software/:path/
- specs:
- output: true
- permalink: /specs/:path/
- posts:
- output: true
- permalink: /blog/:year-:month-:day-:title/
- pages:
- output: true
- permalink: /:name/
-
-
-defaults:
- # Theme defaults.
- # MUST be duplicated from themeโs _config.yml
- # (does not get inherited, unlike the collections hash)
- - scope:
- path: ""
- values:
- layout: default
- - scope:
- path: _posts
- type: posts
- values:
- layout: post
- - scope:
- path: _software
- type: software
- values:
- layout: product
- - scope:
- path: _specs
- type: specs
- values:
- layout: spec
-
-plugins:
- - jekyll-seo-tag
- - jekyll-sitemap
-
-tag_namespaces:
- software:
- writtenin: "Written in"
- bindingsfor: "Bindings for"
- user: "Target user"
- interface: "Interface"
- specs:
- audience: "Audience"
- completion_status: "Status"
-
-exclude:
- - .git
- - .lycheeignore
- - "*/.git"
- - Gemfile*
- - Makefile
- - Rakefile
- - README.adoc
- - vendor # for deployment
diff --git a/_layouts/docs.html b/_layouts/docs.html
deleted file mode 100644
index ac55a1e..0000000
--- a/_layouts/docs.html
+++ /dev/null
@@ -1,37 +0,0 @@
----
-layout: docs-base
-html-class: docs-page
-docs_title: Fontist
-navigation:
- base_url: /docs
- items:
- - title: What is Fontist?
- path: /
- - title: Usage
- path: /usage/
- items:
- - title: How to install a font?
- path: /usage/install/
- - title: How to use Fontist in CI?
- path: /usage/ci/
- - title: How to create a new formula?
- path: /usage/formula/
- - title: How to use Fontconfig with Fontist?
- path: /usage/fontconfig/
- - title: Which archives are supported by Fontist?
- path: /usage/archives/
- - title: How to find installed fonts?
- path: /usage/status/
- - title: How to install a bundle of fonts at once?
- path: /usage/manifest/
- - title: How to change Fontist directory?
- path: /usage/directory/
- - title: How to use proxy servers with Fontist?
- path: /usage/proxy/
- - title: How to use Fontist Ruby library?
- path: /usage/ruby/
- - title: List of known problematic fonts
- path: /usage/exclude/
----
-
-{{ content }}
diff --git a/_pages/blog.html b/_pages/blog.html
deleted file mode 100644
index d9bd06f..0000000
--- a/_pages/blog.html
+++ /dev/null
@@ -1,6 +0,0 @@
----
-title: Blog
-description: Updates on Fontist development.
-layout: blog-index
-hero_include: index-page-hero.html
----
diff --git a/_pages/docs.adoc b/_pages/docs.adoc
deleted file mode 100644
index 22d6c5c..0000000
--- a/_pages/docs.adoc
+++ /dev/null
@@ -1,71 +0,0 @@
----
-layout: docs
-title: What is Fontist?
-html-class: overview
----
-:page-liquid:
-
-= What is Fontist?
-
-Fontist is a simple library to find and download fonts for Windows, Linux and
-Mac.
-
-It uses a formula repository to find where to download a requested font. The
-main formula repository contains a lot of fonts, including Google Fonts, SIL
-Fonts, and macOS add-on fonts.
-
-== Why use Fontist when there are other ways to install fonts?
-
-In general, fonts can be downloaded manually and placed in a system folder.
-Some fonts are even pre-installed with an OS. But fontist allows to install
-fonts programmatically and consistently on all platforms (Windows, macOS, and
-Linux): missing fonts would be installed, existing ones would be found and
-their paths returned.
-
-=== Install font
-
-E.g., the following command would find where to download and install the Arial
-font:
-
-[source,sh]
-----
-fontist install "arial"
-----
-
-=== Install a bunch of fonts
-
-It also allows to install several fonts with a single command.
-
-Image you have a file:
-
-[source,yaml]
-----
-# manifest.yml
----
-Times New Roman:
-Arial:
-Courier New:
-----
-
-Then running:
-
-[source,sh]
-----
-fontist manifest-install manifest.yml
-----
-
-Would install or find all 3 fonts, and return its paths.
-
-=== Use Ruby to install fonts
-
-Also Fontist allows to use its Ruby interface. The former tasks can be done with:
-
-[source,ruby]
-----
-Fontist::Font.install("arial")
-----
-
-[source,ruby]
-----
-Fontist::Manifest::Install.from_file("manifest.yml")
-----
diff --git a/_pages/private-repos.adoc b/_pages/private-repos.adoc
deleted file mode 100644
index 02ce863..0000000
--- a/_pages/private-repos.adoc
+++ /dev/null
@@ -1,79 +0,0 @@
----
-layout: docs-base
-html-class: page
-title: Private repos
-redirect_from:
- - /private-repos/
----
-
-== Private repos
-
-There is an ability to use private fonts via private fontist repo. Fontist repo
-is a git repo which contains YAML formula files. Formulas can be created
-manually (see
-https://github.com/fontist/formulas/tree/master/Formulas[examples]), or
-auto-generated from an archive.
-
-A repo can be either HTTPS or SSH Git repo. In case of SSH, a corresponding SSH
-key should be setup with ssh-agent in order to access this private repo.
-
-The repo setup command fetches a repo's formulas, and saves repo's name and url
-for later use.
-
-Internally all repos are stored at ~/.fontist/formulas/Formulas/private.
-
-[source,sh]
-----
-$ fontist repo setup NAME URL
-----
-
-[example]
-====
-[source,sh]
-----
-fontist repo setup acme https://example.com/acme/formulas.git
-# or
-fontist repo setup acme git@example.com:acme/formulas.git
-----
-====
-
-Then you can just install fonts from this repo:
-
-[source,sh]
-----
-fontist install "private font"
-----
-
-There is no need in any additional command to be run, but if you add new
-formulas to your repo, you can fetch them with the repo update command:
-
-[source,sh]
-----
-fontist repo update acme
-----
-
-If there is a need to avoid using private formulas, the repo can be removed with:
-
-[source,sh]
-----
-fontist repo remove acme
-----
-
-== Private formulas
-
-Authorization of private archives in private formulas can be implemented with
-headers. Here is an example which works with Github releases:
-
-[source,yaml]
-----
-resources:
- fonts.zip:
- urls:
- - url: https://example.com/repos/acme/formulas/releases/assets/38777461
- headers:
- Accept: application/octet-stream
- Authorization: token ghp_1234567890abcdefghi
-----
-
-A token can be obtained on https://github.com/settings/tokens[this page]. It
-should have at least the repo scope.
diff --git a/_pages/software.html b/_pages/software.html
deleted file mode 100644
index b95c555..0000000
--- a/_pages/software.html
+++ /dev/null
@@ -1,6 +0,0 @@
----
-title: Software
-description: Software thatโs part of the Fontist project.
-layout: software-index
-hero_include: index-page-hero.html
----
diff --git a/_pages/specs.html b/_pages/specs.html
deleted file mode 100644
index 7b5c465..0000000
--- a/_pages/specs.html
+++ /dev/null
@@ -1,6 +0,0 @@
----
-title: Specifications
-description: Open specifications related to Fontist project.
-layout: spec-index
-hero_include: index-page-hero.html
----
diff --git a/_software/fontist.adoc b/_software/fontist.adoc
deleted file mode 100644
index 031111c..0000000
--- a/_software/fontist.adoc
+++ /dev/null
@@ -1,17 +0,0 @@
----
-title: Fontist
-description: A simple library to find and download fonts for Windows, Linux and Mac.
-
-repo_url: https://github.com/fontist/fontist
-
-external_links:
- - url: https://github.com/fontist/fontist
-
-docs:
- git_repo_url: https://github.com/fontist/fontist
- git_repo_subtree: docs
-
-tags: ["writtenin:Ruby"]
----
-
-Install openly-licensed fonts on Windows, Linux and Mac!
\ No newline at end of file
diff --git a/_software/fontist/assets/symbol.svg b/_software/fontist/assets/symbol.svg
deleted file mode 100644
index f78f589..0000000
--- a/_software/fontist/assets/symbol.svg
+++ /dev/null
@@ -1 +0,0 @@
-
\ No newline at end of file
diff --git a/_software/formulas.adoc b/_software/formulas.adoc
deleted file mode 100644
index d7b5a03..0000000
--- a/_software/formulas.adoc
+++ /dev/null
@@ -1,19 +0,0 @@
----
-title: Formulas
-description: Fontist Font Formulas
-
-repo_url: https://github.com/fontist/formulas
-repo_branch: v3
-
-external_links:
- - url: https://github.com/fontist/formulas
-
-docs:
- git_repo_url: https://github.com/fontist/formulas
- git_repo_branch: v3
- git_repo_subtree: docs
-
-tags: ["writtenin:Ruby"]
----
-
-This is a main Fontist formulas repository.
\ No newline at end of file
diff --git a/_software/formulas/assets/symbol.svg b/_software/formulas/assets/symbol.svg
deleted file mode 100644
index f78f589..0000000
--- a/_software/formulas/assets/symbol.svg
+++ /dev/null
@@ -1 +0,0 @@
-
\ No newline at end of file
diff --git a/assets/blog/2022-02-11_generated.png b/assets/blog/2022-02-11_generated.png
deleted file mode 100644
index b2df034..0000000
Binary files a/assets/blog/2022-02-11_generated.png and /dev/null differ
diff --git a/assets/blog/2022-02-11_original.jpg b/assets/blog/2022-02-11_original.jpg
deleted file mode 100644
index 1a3756d..0000000
Binary files a/assets/blog/2022-02-11_original.jpg and /dev/null differ
diff --git a/assets/css/style.scss b/assets/css/style.scss
deleted file mode 100644
index 1e71975..0000000
--- a/assets/css/style.scss
+++ /dev/null
@@ -1,61 +0,0 @@
----
----
-
-$primary-color: #333289;
-$accent-color: #6254ff;
-
-@import 'jekyll-theme-open-project';
-
-.main-section {
- > .title {
- font-weight: 500;
- }
-}
-
-body.layout--home > .underlay > .hero {
- .illustration {
- bottom: -100px !important;
-
- svg {
- height: 200px;
- }
- }
-
- > .text {
- > .title {
- font-weight: normal;
- }
- }
-}
-
-body.layout--home {
- > main .custom-intro .summary {
- ul.supported-bibliographies {
- li {
- .label {
- margin-right: 1en;
- }
- .source, .gem {
- white-space: nowrap;
- }
- .source {
- &:after {
- content: ", ";
- }
-
- &:last-child:after {
- content: unset;
- }
- }
- }
- }
- }
-}
-
-body.layout--home {
- > main > .featured-posts {
- .title {
- align-self: flex-start;
- }
- }
-}
diff --git a/assets/symbol.svg b/assets/symbol.svg
deleted file mode 100644
index f78f589..0000000
--- a/assets/symbol.svg
+++ /dev/null
@@ -1 +0,0 @@
-
\ No newline at end of file
diff --git a/_posts/2022-02-11-macos-fonts.adoc b/blog/2022-02-11-macos-fonts.md
similarity index 54%
rename from _posts/2022-02-11-macos-fonts.adoc
rename to blog/2022-02-11-macos-fonts.md
index 63b8738..f97e150 100644
--- a/_posts/2022-02-11-macos-fonts.adoc
+++ b/blog/2022-02-11-macos-fonts.md
@@ -1,26 +1,6 @@
----
-layout: post
-title: "Installing macOS-specific add-on fonts"
-date: 2022-02-11
-categories: documentation
-authors:
- -
- name: Ronald Tse
- email: ronald.tse@ribose.com
- social_links:
- - https://github.com/ronaldtse
- -
- name: Alexey Morozov
- email: alexey.morozov.is@gmail.com
- social_links:
- - https://github.com/alexeymorozov
-
-excerpt: >-
- Learn how to install macOS-specific add-on fonts via the `fontist`
- command-line interface.
----
-
-== Introduction
+# Installing macOS-specific add-on fonts
+
+By **Ronald Tse** and **Alexey Morozov** on 11 Feb 2022
Fontist now allows installing macOS-specific add-on fonts via the `fontist`
command-line interface.
@@ -33,35 +13,32 @@ macOS.
The following demonstration shows how useful this is in a CI environment.
-== Prerequisites
+## Prerequisites
Install the Canela font on macOS using
-https://github.com/fontist/fontist[Fontist]:
+[Fontist](https://github.com/fontist/fontist):
-[source,sh]
-----
+```sh
$ fontist install Canela
-----
+```
-== Example
+## Example
_The Blood Is At The Doorstep_ movie poster uses the Canela font. We can
potentially generate it using ImageMagick in a CI environment.
This is the original poster:
-.Original poster. Source: mdfilmfest.com License: All Rights Reserved.
-[link=https://fontsinuse.com/uses/18269/the-blood-is-at-the-doorstep-movie-poster]
-image::/assets/blog/2022-02-11_original.jpg[Original poster]
+![Original poster](https://i.imgur.com/ZsNgRCZ.png)
+_Source: mdfilmfest.com License: All Rights Reserved._
+[Link to poster](https://fontsinuse.com/uses/18269/the-blood-is-at-the-doorstep-movie-poster)
-As described at the
-https://imagemagick.org/script/convert.php[ImageMagic `convert` page], we can
+As described at the [ImageMagic `convert` page](https://imagemagick.org/script/convert.php), we can
use the `magick convert` command to generate this exact same title.
The command to generate the title:
-[source,sh]
-----
+```sh
$ magick convert \
-size 800x1066 canvas:black \
-font Canela-Regular-Regular \
@@ -74,20 +51,17 @@ $ magick convert \
-kerning 60 -annotate +35+850 'DOOR' \
-kerning 95 -annotate +35+1020 'STEP' \
poster.png
-----
+```
The generated version is pretty much identical (except for the background).
-.Generated poster
-image::/assets/blog/2022-02-11_generated.png[Generated poster]
-
+![Generated poster](https://i.imgur.com/waGfDP8.png)
-== Final thoughts
+## Final thoughts
As always, if you need help with the new functionality, please post at
-https://github.com/fontist/discussions/discussions[Fontist Discussions]!
-
+[Fontist Discussions](https://github.com/fontist/discussions/discussions)!
-== References
+## References
-* https://github.com/fontist/fontist[fontist]
+- [fontist](https://github.com/fontist/fontist)
diff --git a/blog/index.md b/blog/index.md
new file mode 100644
index 0000000..ee94562
--- /dev/null
+++ b/blog/index.md
@@ -0,0 +1,7 @@
+---
+outline: false
+---
+
+**[Installing macOS-specific add-on fonts](./2022-02-11-macos-fonts)** \
+Learn how to install macOS-specific add-on fonts via the fontist command-line interface. \
+By **Ronald Tse** and **Alexey Morozov** on 11 Feb 2022
diff --git a/custom-intro.html b/custom-intro.html
deleted file mode 100644
index a845320..0000000
--- a/custom-intro.html
+++ /dev/null
@@ -1,11 +0,0 @@
-
-
- Fontist: A simple library to find and download fonts for Windows, Linux and Mac.
-
-
diff --git a/docs/usage.adoc b/docs/usage.adoc
deleted file mode 100644
index cdda8e3..0000000
--- a/docs/usage.adoc
+++ /dev/null
@@ -1,8 +0,0 @@
----
-layout: docs
----
-
-= Usage
-
-Fontist can be used via its command-line interface (CLI), or as a
-link:ruby/[Ruby library]. This section describes how to use it with CLI.
diff --git a/docs/usage/archives.adoc b/docs/usage/archives.adoc
deleted file mode 100644
index a03c83a..0000000
--- a/docs/usage/archives.adoc
+++ /dev/null
@@ -1,20 +0,0 @@
----
-layout: docs
----
-
-= Which archives are supported by Fontist?
-
-Fontist uses https://github.com/fontist/excavate[Excavate] to extract archives.
-It allows to find fonts even deeply in nested archives of different types.
-
-The following archive types are supported:
-
-* cab (including "exe" files)
-* tar
-* gzip
-* cpio (both old and new formats)
-* ole ("msi" files)
-* rpm
-* 7z
-* xar
-* zip
diff --git a/docs/usage/ci.adoc b/docs/usage/ci.adoc
deleted file mode 100644
index 23fe089..0000000
--- a/docs/usage/ci.adoc
+++ /dev/null
@@ -1,43 +0,0 @@
----
-layout: docs
----
-
-= How to use Fontist in CI systems?
-
-For example, in Github Actions you can create workflow with the following steps:
-
-[source,yaml]
-----
-- uses: ruby/setup-ruby@v1
- with:
- ruby-version: 2.7
-
-- run: gem install fontist
-
-- run: fontist install --accept-all-licenses "arial"
-----
-
-It would setup Ruby, install Fontist as a gem (a Ruby library), and install the
-Arial font.
-
-== Platform-specific fonts
-
-Some fonts are available only on specific platforms, because of license
-restrictions. For example, the Canela font can be installed only on macOS. To
-install it, just use an image with a proper OS:
-
-[source,yaml]
-----
-runs-on: macos-10.15
-steps:
- - uses: ruby/setup-ruby@v1
- with:
- ruby-version: 2.7
-
- - run: gem install fontist
-
- - run: fontist install --accept-all-licenses "canela"
-----
-
-WARNING: Fontist does not allow installing macOS-specific fonts on non-macOS
-platforms due to font licensing of those fonts.
diff --git a/docs/usage/directory.adoc b/docs/usage/directory.adoc
deleted file mode 100644
index a601f1b..0000000
--- a/docs/usage/directory.adoc
+++ /dev/null
@@ -1,13 +0,0 @@
----
-layout: docs
----
-
-= How to change Fontist directory?
-
-By default Fontist uses the `~/.fontist` directory to store fonts and its
-files. It could be changed with the `FONTIST_PATH` environment variable.
-
-[source,sh]
-----
-FONTIST_PATH=~/.fontist_new fontist update
-----
diff --git a/docs/usage/exclude.adoc b/docs/usage/exclude.adoc
deleted file mode 100644
index 71247f7..0000000
--- a/docs/usage/exclude.adoc
+++ /dev/null
@@ -1,12 +0,0 @@
----
-layout: docs
----
-
-= List of problematic fonts
-
-`fontist` excludes some fonts from usage when they break other software:
-
-* NISC18030.ttf (GB18030 Bitmap) - macOS, more info in
-https://github.com/fontist/fontist/issues/344[the NISC18030 issue]
-
-https://github.com/fontist/fontist/blob/main/lib/fontist/exclude.yml[The up-to-date list of known problematic fonts]
diff --git a/docs/usage/fontconfig.adoc b/docs/usage/fontconfig.adoc
deleted file mode 100644
index 2ca88a5..0000000
--- a/docs/usage/fontconfig.adoc
+++ /dev/null
@@ -1,33 +0,0 @@
----
-layout: docs
----
-
-= How to use Fontconfig with Fontist?
-
-Fontconfig is a software designed to provide fonts to other programs. It is
-typically used on Linux, but also available on macOS and Windows. Fontconfig is
-used by LibreOffice, GIMP, and many other programs.
-
-It order to find fontist fonts, Fontconfig should be updated to include fontist
-paths. It can be done with the `--update-fontconfig` option of `install`:
-
-[source,sh]
-----
-fontist install --update-fontconfig 'courier prime'
-----
-
-Or by calling a special command:
-
-[source,sh]
-----
-fontist fontconfig update
-----
-
-It would create a config in `~/.config/fontconfig/conf.d/10-fontist.conf`.
-
-To remove it, please use:
-
-[source,sh]
-----
-fontist fontconfig remove
-----
diff --git a/docs/usage/formula.adoc b/docs/usage/formula.adoc
deleted file mode 100644
index df73c6b..0000000
--- a/docs/usage/formula.adoc
+++ /dev/null
@@ -1,117 +0,0 @@
----
-layout: docs
----
-
-= How to create a new formula?
-
-Formula's purpose is to let fontist to determine where to download fonts.
-
-There is a command which can generate a formula by an archive's link:
-
-[source,sh]
-----
-fontist create-formula https://quoteunquoteapps.com/courierprime/downloads/courier-prime.zip
-----
-
-A result of its execution would be a yaml file. It can be changed with a text
-editor.
-
-You may need to change it manually when:
-
-- the script could not detect proper license text
-- you would like to change a name of a formula (may use the `--name` option)
-- the archive is private (see <>)
-
-The formula can be proposed to be merged to
-https://github.com/fontist/formulas[the main repository], or added to a private
-repository.
-
-== How to create a private repository
-
-Fontist supports additional formulas repositories, called "private".
-
-To create a new private repository, setup a new git repository, and place
-formulas there:
-
-[source,sh]
-----
-mkdir acme
-cd acme
-git init
-cp ../courier_prime.yml . # from example above
-git add courier_prime.yml
-git commit -m "Add formula for Courier Prime"
-git remote add origin git@example.com:acme/formulas.git # use your git hosting
-git push origin main -u
-----
-
-== How to add a private repository to Fontist
-
-In order to find the private repository, fontist should be called with its URL
-or path:
-
-[source,sh]
-----
-fontist repo setup NAME URL
-----
-
-E.g.
-
-[source,sh]
-----
-fontist repo setup acme https://example.com/acme/formulas.git
-# or
-fontist repo setup acme git@example.com:acme/formulas.git
-----
-
-Then fonts from this repo can be installed:
-
-[source,sh]
-----
-fontist install "courier prime"
-----
-
-NOTE: A repository can be either an HTTPS or SSH Git repo. In case of SSH, a
-corresponding SSH key should be setup with `ssh-agent` in order to access this
-private repository.
-
-== How to update a private repository
-
-If the private Fontist formula repository is updated, you can fetch the updates
-with the `repo update` command:
-
-[source,sh]
-----
-fontist repo update acme
-----
-
-If there is a need to avoid using private formulas, the repo can be removed
-with:
-
-[source,sh]
-----
-fontist repo remove acme
-----
-
-[[private-formula-authentication]]
-== Authentication for private formulas or private formula repositories
-
-Authorization of private archives in private formulas can be implemented with
-headers.
-
-Here is an example which works with Github releases:
-
-[source,yaml]
-----
-resources:
- fonts.zip:
- urls:
- - url: https://example.com/repos/acme/formulas/releases/assets/38777461
- headers:
- Accept: application/octet-stream
- Authorization: token ghp_1234567890abcdefghi
-----
-
-A token can be obtained on the
-https://github.com/settings/tokens[GitHub Settings > Tokens page].
-This token should have at least the `repo` scope for access to these assets.
diff --git a/docs/usage/install.adoc b/docs/usage/install.adoc
deleted file mode 100644
index 61b2d25..0000000
--- a/docs/usage/install.adoc
+++ /dev/null
@@ -1,96 +0,0 @@
----
-layout: docs
----
-
-= How to install a font?
-
-Fontist checks whether this font is already installed, and if not, then
-installs the font and returns its installed paths.
-
-The font name is the only argument to be supplied.
-
-[source,sh]
-----
-$ fontist install "segoe ui"
-These fonts are found or installed:
-- /Users/user/.fontist/fonts/SEGOEUI.TTF
-- /Users/user/.fontist/fonts/SEGOEUIB.TTF
-- /Users/user/.fontist/fonts/SEGOEUII.TTF
-- /Users/user/.fontist/fonts/SEGOEUIZ.TTF
-----
-
-If the font's formula requires license acceptable, then it will be asked.
-
-[source,sh]
-----
-Do you accept all presented font licenses, and want Fontist to download these fonts for you? => TYPE 'Yes' or 'No':
-----
-
-It can be accepted either by typing 'yes', or by the `-a, --accept-all-licenses`
-option.
-
-== How to install a whole formula?
-
-To install all fonts specified in a Fontist formula, use the `-F, --formula`
-option.
-
-[source,sh]
-----
-$ fontist install --formula 'courier_prime'
-Downloading font ...
-Installing font "courier_prime".
-Fonts installed at:
-- /Users/user/.fontist/fonts/Courier Prime Bold Italic.ttf
-- /Users/user/.fontist/fonts/Courier Prime Bold.ttf
-- /Users/user/.fontist/fonts/Courier Prime Italic.ttf
-- /Users/user/.fontist/fonts/Courier Prime.ttf
-----
-
-Here, `courier_prime` is the filename of the formula located at the public
-Fontist Formula repository
-(https://github.com/fontist/formulas/blob/v3/Formulas/courier_prime.yml[`courier_prime.yml`]).
-
-NOTE: Specifying the font's filename is not supported.
-
-== Way of searching for a formula
-
-If there are several formulas with a requested font, then `fontist` searches
-for the newest version of the font among formulas with size below a limit
-(300 MB). This behavior can be changed with options.
-
-NOTE: If styles of a font are spread among several formulas, then all
-available formulas would be installed.
-
-== Supported options
-
-`-f, [--force]`:: Install even if already installed in system
-`-F, [--formula]`:: Install whole formula instead of a font
-`-a, [--accept-all-licenses]`:: Accept all license agreements
-`-h, [--hide-licenses]`:: Hide license texts
-`-p, [--no-progress]`:: Hide download progress
-`-V, [--version=VERSION]`:: Install particular version of a font
-`-s, [--smallest]`:: Install the smallest font by file size if several
-`-n, [--newest]`:: Install the newest version of a font if several
-`-S, [--size-limit=N]`:: Specify upper limit for file size of a formula to be
- installed (default is 300 MB)
-`-u, [--update-fontconfig]`:: Update Fontconfig
-
-
-NOTE: The `install` command is similar to the `Font.install` library call.
-
-== How to uninstall fonts?
-
-To uninstall any font installed by Fontist:
-
-[source,sh]
-----
-$ fontist uninstall "segoe ui"
-These fonts are removed:
-/Users/user/.fontist/fonts/SEGOEUII.TTF
-/Users/user/.fontist/fonts/SEGOEUIZ.TTF
-/Users/user/.fontist/fonts/SEGOEUIB.TTF
-/Users/user/.fontist/fonts/SEGOEUI.TTF
-----
-
-Returns paths of an uninstalled font, or prints an error telling that the font
-isn't installed or could not be found in Fontist formulas. Aliased as `remove`.
diff --git a/docs/usage/manifest.adoc b/docs/usage/manifest.adoc
deleted file mode 100644
index 159ee7a..0000000
--- a/docs/usage/manifest.adoc
+++ /dev/null
@@ -1,65 +0,0 @@
----
-layout: docs
----
-
-= How to install a bundle of fonts at once?
-
-Several fonts can be specified in a file, called "manifest", and installed
-together.
-
-First, prepare a file "manifest.yml":
-
-[source,yaml]
-----
----
-Times New Roman:
-Arial:
-Courier New:
-----
-
-Then run:
-
-[source,sh]
-----
-fontist manifest-install manifest.yml
-----
-
-This command would install or find all 3 fonts, and return its paths.
-
-== How to get paths of installed fonts?
-
-Once you installed fonts via the manifest file, you can get their locations:
-
-[source,sh]
-----
-fontist manifest-locations manifest.yml
-----
-
-The output is in the YAML format:
-
-[source,sh]
-----
----
-Times New Roman:
- Bold Italic:
- full_name: Times New Roman Bold Italic
- paths:
- - "/System/Library/Fonts/Supplemental/Times New Roman Bold Italic.ttf"
- - "/Users/user/.fontist/fonts/timesbi.ttf"
- Italic:
- full_name: Times New Roman Italic
- paths:
- - "/System/Library/Fonts/Supplemental/Times New Roman Italic.ttf"
- - "/Users/user/.fontist/fonts/timesi.ttf"
-----
-
-If one or some of requested fonts are missing, the "3" error code would be
-returned, and a message printed:
-
-[source,sh]
-----
-$ fontist manifest-locations manifest.yml
-'Roboto Mono' 'Regular' font is missing, please run `fontist install 'Roboto Mono'` to download the font.
-$ echo $?
-3
-----
diff --git a/docs/usage/proxy.adoc b/docs/usage/proxy.adoc
deleted file mode 100644
index a283511..0000000
--- a/docs/usage/proxy.adoc
+++ /dev/null
@@ -1,58 +0,0 @@
----
-layout: docs
----
-
-= How to use proxy servers with Fontist?
-
-Fontist uses Git internally for fetching formulas and fonts.
-
-In order to use Git functionality behind a proxy, you need to update your own
-Git config via the `git config` command or the `~/.gitconfig` preference file.
-
-There are many ways to configure your local Git install to use proxies.
-
-The simplest, global way of setting a proxy for Git is the following.
-
-* For HTTP
-+
-[source,sh]
-----
-git config --global http.proxy http://{user}:{pass}@{proxyhost}:{port}
-----
-
-* For HTTPS, you may need to handle SSL/TLS verification errors after setting
-the proxy since the encryption end is located at your HTTPS proxy endpoint:
-+
-[source,sh]
-----
-git config --global http.proxy https://{user}:{pass}@{proxyhost}:{port}
-git config --global https.proxy https://{user}:{pass}@{proxyhost}:{port}
-----
-
-* For SOCKS, you will need to decide on the SOCKS protocol
-+
-[source,sh]
-----
-git config --global http.proxy '{protocol}://{user}:{pass}@{proxyhost}:{port}'
-git config --global https.proxy '{protocol}://{user}:{pass}@{proxyhost}:{port}'
-----
-+
-For example,
-+
-[source,sh]
-----
-git config --global http.proxy 'socks5h://user:pass@socks-proxy.example.org'
-git config --global https.proxy 'socks5h://user:pass@socks-proxy.example.org'
-----
-
-The list of supported SOCKS protocols for the `{protocol}` field:
-
-* `socks://`: for SOCKS below v5
-* `socks5://`: for SOCKS v5
-* `socks5h://`: for SOCKS below v5 + host resolution via SOCKS
-
-You could actually set different proxy behavior for individual Git repositories
--- please see this
-https://gist.github.com/evantoli/f8c23a37eb3558ab8765[great guide]
-on how to use Git proxies (thanks to the GitHub user
-https://github.com/evantoli[evantoli]).
diff --git a/docs/usage/ruby.adoc b/docs/usage/ruby.adoc
deleted file mode 100644
index 37d9cde..0000000
--- a/docs/usage/ruby.adoc
+++ /dev/null
@@ -1,239 +0,0 @@
----
-layout: docs
----
-
-= How to use Fontist Ruby library?
-
-In addition to the command-line interface Fontist can be used as a Ruby library.
-
-== Fontist::Font
-
-The `Fontist::Font` is your go-to place to deal with any font using Fontist.
-
-This interface allows you to find a font or install a font.
-
-=== Finding a font
-
-The `Fontist::Font.find` interface can be used a find a font in your system.
-
-It will look into the operating system specific font directories, and also the
-fontist specific `~/.fontist` directory.
-
-[source,ruby]
-----
-Fontist::Font.find(name)
-----
-
-* If Fontist finds a font, then it will return the paths.
-
-* Otherwise, it will either raise an unsupported font error, or trigger display
-of installation instructions for that specific font.
-
-=== Install a font
-
-The `Fontist::Font.install` interface can be used to install any supported font.
-
-This interface first checks if you already have that font installed or not and
-if you do then it will return the paths.
-
-If you don't have a font but that font is supported by Fontist, then it will
-download the font and copy it to `~/.fontist` directory and also return the
-paths.
-
-[source,ruby]
-----
-Fontist::Font.install(name, confirmation: "no")
-----
-
-If there are issues detected with the provided font, such as the font is not
-supported, those errors would be raised.
-
-=== List all fonts
-
-The `Fontist::Font` interface exposes an interface to list all supported fonts.
-
-This might be useful if want to know the name of the font or the available
-styles. You can do that by using:
-
-[source,ruby]
-----
-Fontist::Font.all
-----
-
-The return values are `OpenStruct` objects, so you can easily do any other
-operation you would do in any ruby object.
-
-== Fontist::Formula
-
-The `fontist` gem internally usages the `Fontist::Formula` interface to find a
-registered formula or fonts supported by any formula. Unless, you need to do
-anything with that you shouldn't need to work with this interface directly. But
-if you do then these are the public interface it offers.
-
-=== Find a formula
-
-The `Fontist::Formula.find` interface allows you to find any of the registered
-formula. This interface takes a font name as an argument and it looks through
-each of the registered formula that offers this font installation. Usages:
-
-[source,ruby]
-----
-Fontist::Formula.find("Calibri")
-----
-
-This method will search and return a Fontist formula for the provided keyword
-which allows for further processing, such as license checks or proceeding with
-installation of the font in your system.
-
-=== List font styles supported by a formula
-
-Normally, each font name can be associated with multiple styles or collection,
-for example the `Calibri` font might contains a `regular`, `bold` or `italic`
-styles fonts and if you want a interface that can return the complete list then
-this is your friend.
-
-You can use it as following:
-
-[source,ruby]
-----
-Fontist::Formula.find_fonts("Calibri")
-----
-
-=== List all formulas
-
-The `Fontist::Formula` interface exposes an interface to list all registered
-font formula. This might be useful if want to know the name of the formula or
-what type fonts can be installed using that formula. Usages:
-
-[source,ruby]
-----
-Fontist::Formula.all
-----
-
-The return values are `OpenStruct` objects, so you can easily do any other
-operation you would do in any ruby object.
-
-== Fontist::Manifest
-
-=== Global options
-
-Fontist can be switched to use the preferred family names. This format was
-used prior to v1.10.
-
-[source,ruby]
-----
-Fontist.preferred_family = true
-----
-
-[[fontist-locations]]
-=== Fontist::Manifest::Locations
-
-Fontist lets you find font locations from a defined manifest Hash in the
-following format:
-
-[source,ruby]
-----
-{
- "Segoe UI"=>["Regular", "Bold"],
- "Roboto Mono"=>["Regular"]
-}
-----
-
-Calling the following code returns a nested Hash with font paths and names.
-Font name is useful to choose a specific font in a font collection file (TTC).
-
-[source,ruby]
-----
-Fontist::Manifest::Locations.from_hash(manifest)
-----
-
-[source,ruby]
-----
-{
- "Segoe UI"=> {
- "Regular"=>{
- "full_name"=>"Segoe UI",
- "paths"=>["/Users/user/.fontist/fonts/SEGOEUI.TTF"]
- },
- "Bold"=>{
- "full_name"=>"Segoe UI Bold",
- "paths"=>["/Users/user/.fontist/fonts/SEGOEUIB.TTF"]
- }
- },
- "Roboto Mono"=> {
- "Regular"=>{
- "full_name"=>nil,
- "paths"=>[]
- }
- }
-}
-----
-
-[[fontist-install]]
-=== Fontist::Manifest::Install
-
-Fontist lets you not only to obtain font locations but also to install fonts
-from the manifest:
-
-[source,ruby]
-----
-Fontist::Manifest::Install.from_hash(manifest, confirmation: "yes")
-----
-
-It will install fonts and return their locations:
-
-[source,ruby]
-----
-{
- "Segoe UI"=> {
- "Regular"=>{
- "full_name"=>"Segoe UI",
- "paths"=>["/Users/user/.fontist/fonts/SEGOEUI.TTF"]},
- "Bold"=>{
- "full_name"=>"Segoe UI Bold",
- "paths"=>["/Users/user/.fontist/fonts/SEGOEUIB.TTF"]
- }
- },
- "Roboto Mono"=> {
- "Regular"=>{
- "full_name"=>"Roboto Mono Regular",
- "paths"=>["/Users/user/.fontist/fonts/RobotoMono-VariableFont_wght.ttf"]
- }
- }
-}
-----
-
-=== Support of YAML format
-
-Both commands support a YAML file as an input with a `from_file` method. For
-example, if there is a `manifest.yml` file containing:
-
-[source,yaml]
-----
----
-Segoe UI:
-- Regular
-- Bold
-Roboto Mono:
-- Regular
-----
-
-Then the following calls would return font names and paths, as from the
-`from_hash` method (see <> and <>).
-
-[source,ruby]
-----
-Fontist::Manifest::Locations.from_file("manifest.yml")
-Fontist::Manifest::Install.from_file("manifest.yml", confirmation: "yes")
-----
-
-== Fontist::Fontconfig
-
-Fontist supports work with Fontconfig via the Ruby interface:
-
-[source,ruby]
-----
-Fontist::Fontconfig.update # let detect fontist fonts
-Fontist::Fontconfig.remove # disable detection
-Fontist::Fontconfig.remove(force: true) # do not fail if no config exists
-----
diff --git a/docs/usage/status.adoc b/docs/usage/status.adoc
deleted file mode 100644
index 3380567..0000000
--- a/docs/usage/status.adoc
+++ /dev/null
@@ -1,78 +0,0 @@
----
-layout: docs
----
-
-= How to find installed fonts?
-
-The `status` command shows fonts paths.
-
-[source,sh]
-----
-$ fontist status "segoe ui"
-Fonts found at:
-- /Users/user/.fontist/fonts/SEGOEUII.TTF (from segoe_ui formula)
-- /Users/user/.fontist/fonts/SEGOEUIZ.TTF (from segoe_ui formula)
-- /Users/user/.fontist/fonts/SEGOEUIB.TTF (from segoe_ui formula)
-- /Users/user/.fontist/fonts/SEGOEUI.TTF (from segoe_ui formula)
-----
-
-With no argument it prints all fonts found in a system:
-
-[source,sh]
-----
-$ fontist status
-Fonts found at:
-- /Library/Fonts/Arial Unicode.ttf
-- /System/Library/Fonts/Symbol.ttf
-- /System/Library/Fonts/SFNSMono.ttf
-...
-- /Users/user/.fontist/fonts/SEGOEUII.TTF (from segoe_ui formula)
-- /Users/user/.fontist/fonts/SEGOEUIZ.TTF (from segoe_ui formula)
-- /Users/user/.fontist/fonts/SEGOEUIB.TTF (from segoe_ui formula)
-- /Users/user/.fontist/fonts/SEGOEUI.TTF (from segoe_ui formula)
-----
-
-== How to see available fonts?
-
-To see which formulas contain a requested font:
-
-[source,sh]
-----
-$ fontist list "arial"
-eurofix
- Arial
- Bold (uninstalled)
- Bold Italic (uninstalled)
- Italic (uninstalled)
- Regular (uninstalled)
-ms_truetype
- Arial
- Regular (uninstalled)
- Bold (uninstalled)
- Bold Italic (uninstalled)
- Italic (uninstalled)
-webcore
- Arial
- Regular (uninstalled)
- Bold (uninstalled)
- Bold Italic (uninstalled)
- Italic (uninstalled)
-----
-
-Again, with no argument it prints all available fonts in all formulas:
-
-[source,sh]
-----
-$ fontist list
-courier_prime
- Courier Prime
- Bold (uninstalled)
- Bold Italic (uninstalled)
- Italic (uninstalled)
- Regular (uninstalled)
-courier_prime_cyrillic
- Courier Prime
- Bold (uninstalled)
- Bold Italic (uninstalled)
-...
-----
diff --git a/index.adoc b/index.adoc
deleted file mode 100644
index d596584..0000000
--- a/index.adoc
+++ /dev/null
@@ -1,4 +0,0 @@
----
-layout: home
-hero_include: home-hero.html
----
diff --git a/index.md b/index.md
new file mode 100644
index 0000000..104afcb
--- /dev/null
+++ b/index.md
@@ -0,0 +1,44 @@
+---
+# https://vitepress.dev/reference/default-theme-home-page
+layout: home
+pageClass: my-index-page
+
+features:
+ - title: ๐ Fontist
+ details: ๐ฉโ๐ป Install openly-licensed fonts on Windows, Linux and Mac!
+ link: https://fontist.org/fontist/
+ linkText: Go to Fontist
+ - title: ๐ฆ Formulas
+ details: ๐ Searchable index of all installable Fontist Formulas
+ link: https://fontist.org/formulas/
+ linkText: Go to Formulas
+---
+
+
+
+
+
+