From 929358640f8ba00dd78e42e412c5e4413f8b6b4a Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Glauco=20Cust=C3=B3dio?= Date: Sat, 20 Jul 2024 10:01:00 +0100 Subject: [PATCH] add example --- .vscode/settings.json | 5 +++++ _config.yml | 2 +- _sass/custom/custom.scss | 40 ++++++++++++++++++++++++++++++++++++++++ index.html | 30 ++++++++++++++++++++++++++++++ index.md | 35 ----------------------------------- 5 files changed, 76 insertions(+), 36 deletions(-) create mode 100644 .vscode/settings.json create mode 100644 _sass/custom/custom.scss create mode 100644 index.html delete mode 100644 index.md diff --git a/.vscode/settings.json b/.vscode/settings.json new file mode 100644 index 0000000..65e7b97 --- /dev/null +++ b/.vscode/settings.json @@ -0,0 +1,5 @@ +{ + "[html]": { + "editor.formatOnSave": false + }, +} diff --git a/_config.yml b/_config.yml index 5cab035..ab2a015 100644 --- a/_config.yml +++ b/_config.yml @@ -5,4 +5,4 @@ theme: just-the-docs url: https://evenbetterspecs.github.io aux_links: - Template Repository: https://github.com/just-the-docs/just-the-docs-template + GitHub: https://github.com/evenbetterspecs/ diff --git a/_sass/custom/custom.scss b/_sass/custom/custom.scss new file mode 100644 index 0000000..a364dee --- /dev/null +++ b/_sass/custom/custom.scss @@ -0,0 +1,40 @@ +.bad, +.good { + background: #e8e8e8; + padding: 5px 0px 0px 0; + + &::before { + padding: 0 10px; + } + + .highlight { + margin-top: 3px; + } +} + +.bad { + color: red; + + &::before { + content: "BAD"; + } +} + +.good { + color: green; + + &::before { + content: "GOOD"; + } +} + +.main-content { + + h2 { + &:first-child { + margin-top: 0; + } + + margin-bottom: 0.75em; + } +} diff --git a/index.html b/index.html new file mode 100644 index 0000000..80b038a --- /dev/null +++ b/index.html @@ -0,0 +1,30 @@ +--- +title: Home +layout: home +--- + +
+

+ + Describe what you are testing + +

+ +

Be clear about what method you are describing. For instance, use the Ruby documentation convention of . when referring to a class method's name and # when referring to an instance method's name.

+ +
+{% highlight ruby %} +describe 'the authenticate method for User' do +describe 'if the user is an admin' do +describe 'create url' do +{% endhighlight %} +
+ +
+{% highlight ruby %} +describe '.authenticate' do +describe '#admin?' do +describe '#create' do +{% endhighlight %} +
+
diff --git a/index.md b/index.md deleted file mode 100644 index ca0c545..0000000 --- a/index.md +++ /dev/null @@ -1,35 +0,0 @@ ---- -title: Home -layout: home ---- - -This is a *bare-minimum* template to create a Jekyll site that uses the [Just the Docs] theme. You can easily set the created site to be published on [GitHub Pages] – the [README] file explains how to do that, along with other details. - -If [Jekyll] is installed on your computer, you can also build and preview the created site *locally*. This lets you test changes before committing them, and avoids waiting for GitHub Pages.[^1] And you will be able to deploy your local build to a different platform than GitHub Pages. - -More specifically, the created site: - -- uses a gem-based approach, i.e. uses a `Gemfile` and loads the `just-the-docs` gem -- uses the [GitHub Pages / Actions workflow] to build and publish the site on GitHub Pages - -Other than that, you're free to customize sites that you create with this template, however you like. You can easily change the versions of `just-the-docs` and Jekyll it uses, as well as adding further plugins. - -[Browse our documentation][Just the Docs] to learn more about how to use this theme. - -To get started with creating a site, simply: - -1. click "[use this template]" to create a GitHub repository -2. go to Settings > Pages > Build and deployment > Source, and select GitHub Actions - -If you want to maintain your docs in the `docs` directory of an existing project repo, see [Hosting your docs from an existing project repo](https://github.com/just-the-docs/just-the-docs-template/blob/main/README.md#hosting-your-docs-from-an-existing-project-repo) in the template README. - ----- - -[^1]: [It can take up to 10 minutes for changes to your site to publish after you push the changes to GitHub](https://docs.github.com/en/pages/setting-up-a-github-pages-site-with-jekyll/creating-a-github-pages-site-with-jekyll#creating-your-site). - -[Just the Docs]: https://just-the-docs.github.io/just-the-docs/ -[GitHub Pages]: https://docs.github.com/en/pages -[README]: https://github.com/just-the-docs/just-the-docs-template/blob/main/README.md -[Jekyll]: https://jekyllrb.com -[GitHub Pages / Actions workflow]: https://github.blog/changelog/2022-07-27-github-pages-custom-github-actions-workflows-beta/ -[use this template]: https://github.com/just-the-docs/just-the-docs-template/generate