From 04ea930e10f8409e88a70d20bf2ab2c7d86831a1 Mon Sep 17 00:00:00 2001 From: delisma Date: Thu, 17 Jun 2021 21:20:28 -0400 Subject: [PATCH] Can't navigate from splash page on the demo site Fixes #11 --- README.md | 26 +- _pages/en/another-page.md | 19 - _pages/en/another-test-page.md | 12 + _pages/en/gh-pages.md | 9 + _pages/en/index.md | 174 ++------- _pages/en/pages.md | 9 + _pages/en/settings.md | 382 +++++++++++++++++++ _pages/en/setup.md | 50 +++ _pages/en/test-page.md | 126 ++++++ _pages/en/translation.md | 42 ++ api-publique.md => _pages/fr/api-publique.md | 0 _pages/fr/autre-page-test.md | 12 + _pages/fr/autre-page.md | 19 - _pages/fr/configuration.md | 53 +++ _pages/fr/gh-pages.md | 9 + _pages/fr/index.md | 176 ++------- _pages/fr/page-test.md | 125 ++++++ _pages/fr/pages.md | 9 + _pages/fr/personnalisation.md | 174 +++++++++ _pages/fr/traductions.md | 9 + 20 files changed, 1118 insertions(+), 317 deletions(-) delete mode 100644 _pages/en/another-page.md create mode 100644 _pages/en/another-test-page.md create mode 100644 _pages/en/gh-pages.md create mode 100644 _pages/en/pages.md create mode 100644 _pages/en/settings.md create mode 100644 _pages/en/setup.md create mode 100644 _pages/en/test-page.md create mode 100644 _pages/en/translation.md rename api-publique.md => _pages/fr/api-publique.md (100%) create mode 100644 _pages/fr/autre-page-test.md delete mode 100644 _pages/fr/autre-page.md create mode 100644 _pages/fr/configuration.md create mode 100644 _pages/fr/gh-pages.md create mode 100644 _pages/fr/page-test.md create mode 100644 _pages/fr/pages.md create mode 100644 _pages/fr/personnalisation.md create mode 100644 _pages/fr/traductions.md diff --git a/README.md b/README.md index b000139..289a754 100644 --- a/README.md +++ b/README.md @@ -1,9 +1,9 @@ # Jekyll theme for GCweb -[![Contributor Covenant](https://img.shields.io/badge/Contributor%20Covenant-v1.4%20adopted-ff69b4.svg)](code-of-conduct.md) [![Build Status](https://travis-ci.org/wet-boew/gcweb-jekyll.svg?branch=master)](https://travis-ci.org/wet-boew/gcweb-jekyll) [![Gem Version](https://badge.fury.io/rb/jekyll-theme-gcweb.svg)](https://badge.fury.io/rb/jekyll-theme-gcweb) +[![Contributor Covenant](https://img.shields.io/badge/Contributor%20Covenant-v1.4%20adopted-ff69b4.svg)](code-of-conduct.md) [![Gem Version (deprecated)](https://badge.fury.io/rb/gcweb-jekyll.svg)](https://badge.fury.io/rb/gcweb-jekyll) *GCweb is a Jekyll theme for Government of Canada websites. You can [preview the theme to see what it looks like](http://wet-boew.github.io/gcweb-jekyll), or even [use it today](#usage).* -## Usage +## Usage (deprecated) > **_NOTE:_** GCweb is the default theme for Government of Canada websites, but you can still specify the theme you're using as below. @@ -23,9 +23,9 @@ To use the GCweb theme: -## Customizing +## Customizing (deprecated) -### Configuration variables +### Configuration variables (deprecated) GCweb will respect the following variables, if set in your site's `_config.yml`: @@ -40,7 +40,7 @@ Additionally, you may choose to set the following optional variables: google_analytics: [Your Google Analytics tracking ID] ``` -### Stylesheet +### Stylesheet (deprecated) If you'd like to add your own custom styles: @@ -54,7 +54,7 @@ If you'd like to add your own custom styles: ``` 3. Add any custom CSS (or Sass, including imports) you'd like immediately after the `@import` line -### Layouts +### Layouts (deprecated) If you'd like to change the theme's HTML layout: @@ -69,7 +69,7 @@ See the [open issues](https://github.com/wet-boew/gcweb-jekyll/issues) for a lis ## Project philosophy -The GCweb theme is intended to make it quick and easy for Government of Canada employees to create their first (or 100th) website of GitHub for their organisation. The theme should meet the vast majority of users' needs out of the box, erring on the side of simplicity rather than flexibility, and provide users the opportunity to opt-in to additional complexity if they have specific needs or wish to further customize their experience (such as adding custom CSS or modifying the default layout). It should also look great, but that goes without saying. +The GCweb theme is intended to make it quick and easy for Government of Canada employees to create their first (or 100th) website off GitHub for their organisation. The theme should meet the vast majority of users' needs out of the box, erring on the side of simplicity rather than flexibility, and provide users the opportunity to opt-in to additional complexity if they have specific needs or wish to further customize their experience (such as adding custom CSS or modifying the default layout). It should also look great, but that goes without saying. ## How to Contribute @@ -79,11 +79,11 @@ See [CONTRIBUTING.md](CONTRIBUTING.md) _(French version will be available shortly)_ # Le thème Jekyll de GCweb -[![Build Status](https://travis-ci.org/wet-boew/gcweb-jekyll.svg?branch=master)](https://travis-ci.org/wet-boew/gcweb-jekyll) [![Gem Version](https://badge.fury.io/rb/jekyll-theme-gcweb.svg)](https://badge.fury.io/rb/jekyll-theme-gcweb) +[![Gem Version (désuet)](https://badge.fury.io/rb/gcweb-jekyll.svg)](https://badge.fury.io/rb/gcweb-jekyll) *gcweb-jeckyll est un the Jekyll pour les sites web du gouvernement du Canada. Vous pouvez [voir un aperçu du thème pour avoir une idée de ce à quoi cela ressemble](http://wet-boew.github.io/gcweb-jekyll), ou sinon [vous pouvez l'utiliser maintenant](#utlisitation).* -## Utilisation +## Utilisation (désuet) > **_REMARQUE :_** GCweb is the default theme for Government of Canada websites, but you can still specify the theme you're using as below. @@ -103,9 +103,9 @@ To use the GCweb theme: -## Customizing +## Customizing (désuet) -### Configuration variables +### Configuration variables (désuet) GCweb will respect the following variables, if set in your site's `_config.yml`: @@ -120,7 +120,7 @@ Additionally, you may choose to set the following optional variables: google_analytics: [Your Google Analytics tracking ID] ``` -### Stylesheet +### Stylesheet (désuet) If you'd like to add your own custom styles: @@ -134,7 +134,7 @@ If you'd like to add your own custom styles: ``` 3. Add any custom CSS (or Sass, including imports) you'd like immediately after the `@import` line -### Layouts +### Layouts (désuet) If you'd like to change the theme's HTML layout: diff --git a/_pages/en/another-page.md b/_pages/en/another-page.md deleted file mode 100644 index b53a5dd..0000000 --- a/_pages/en/another-page.md +++ /dev/null @@ -1,19 +0,0 @@ ---- -altLangPrefix: autre-page -dateModified: 2020-01-08 -description: - en: This is just another page -footer: true -langtoggle: true -lang: en -noMainContainer: false -sitemenu: true -sitesearch: true -title: Another page ---- - -## Welcome to another page - -_yay_ - -[back](./) diff --git a/_pages/en/another-test-page.md b/_pages/en/another-test-page.md new file mode 100644 index 0000000..9919d7f --- /dev/null +++ b/_pages/en/another-test-page.md @@ -0,0 +1,12 @@ +--- +altLangPrefix: /fr/autre-page-test +dateModified: 2020-01-08 +description: This is just another page +title: Another page +--- + +## Welcome to another page + +_yay_ + +[back](./test-page.html) diff --git a/_pages/en/gh-pages.md b/_pages/en/gh-pages.md new file mode 100644 index 0000000..a8040aa --- /dev/null +++ b/_pages/en/gh-pages.md @@ -0,0 +1,9 @@ +--- +altLangPage: /fr/gh-pages +breadcrumbs: + - title: "GCWeb Jekyll" + link: "/en/index" +dateModified: 2021-06-31 +description: +title: GitHub pages +--- \ No newline at end of file diff --git a/_pages/en/index.md b/_pages/en/index.md index 3e33f1f..21b4f0b 100644 --- a/_pages/en/index.md +++ b/_pages/en/index.md @@ -1,135 +1,45 @@ --- -altLangPrefix: index -authorName: Service Canada -authorUrl: -contentTitle: Canada.ca Jekyll theme -dateModified: 2020-01-10 +altLangPage: /fr/index +dateModified: 2021-06-31 description: - en: "Get quick, easy access to all Government of Canada services and information." - fr: "Accédez rapidement et facilement à tous les services et renseignements du gouvernement du Canada." -noContentTitle: true -pageclass: wb-prettify all-pre -subject: - en: [GV Government and Politics, Government services] - fr: [GV Gouvernement et vie politique, Services gouvernementaux] -title: Test page - Canada.ca +layout: layout-home +title: GCWeb Jekyll --- -# {{ page.contentTitle }} - -This is a normal paragraph following a header. GitHub is a code hosting platform for version control and collaboration. It lets you and others work together on projects from anywhere. - -Text can be **bold**, _italic_, or ~~strikethrough~~. - -[Link to another page](./another-page.html). - -There should be whitespace between paragraphs. - -There should be whitespace between paragraphs. We recommend including a README, or a file with information about your project. - -## Header 2 - -> This is a blockquote following a header. -> -> When something is important enough, you do it even if the odds are not in your favor. - -### Header 3 - -```js -// Javascript code with syntax highlighting. -var fun = function lang(l) { - dateformat.i18n = require('./lang/' + l) - return true; -} -``` - -```ruby -# Ruby code with syntax highlighting -GitHubPages::Dependencies.gems.each do |gem, version| - s.add_dependency(gem, "= #{version}") -end -``` - -#### Header 4 - -* This is an unordered list following a header. -* This is an unordered list following a header. -* This is an unordered list following a header. - -##### Header 5 - -1. This is an ordered list following a header. -2. This is an ordered list following a header. -3. This is an ordered list following a header. - -###### Header 6 - -| head1 | head two | three | -|:-------------|:------------------|:------| -| ok | good swedish fish | nice | -| out of stock | good and plenty | nice | -| ok | good `oreos` | hmm | -| ok | good `zoute` drop | yumm | - -### There's a horizontal rule below this. - -* * * - -### Here is an unordered list: - -* Item foo -* Item bar -* Item baz -* Item zip - -### And an ordered list: - -1. Item one -1. Item two -1. Item three -1. Item four - -### And a nested list: - -- level 1 item - - level 2 item - - level 2 item - - level 3 item - - level 3 item -- level 1 item - - level 2 item - - level 2 item - - level 2 item -- level 1 item - - level 2 item - - level 2 item -- level 1 item - -### Small image - -![Octocat](https://github.githubassets.com/images/icons/emoji/octocat.png) - -### Large image - -![Branching](https://guides.github.com/activities/hello-world/branching.png){: .img-responsive} - - -### Definition lists can be used with HTML syntax. - -
-
Name
-
Godzilla
-
Born
-
1952
-
Birthplace
-
Japan
-
Color
-
Green
-
- -``` -Long, single-line code blocks should not wrap. They should horizontally scroll if they are too long. This line should be long enough to demonstrate this. -``` - -``` -The final element. -``` \ No newline at end of file +
+
+
+

GCWeb Jekyll

+

Welcome to the GCWeb Jekyll template website

+
+
+
+
+
+

Most requested

+ +
+
+
+

Services and information

+
+
+

Setup

+

Setup your local environment and install the template.

+
+
+

Settings

+

Customize your website, changing the layouts, titles, etc.

+
+
+

Pages

+

Create pages and use the Front Matter properties

+
+
+

GitHub pages

+

Deploy your website using gh-pages and edit your content.

+
+
\ No newline at end of file diff --git a/_pages/en/pages.md b/_pages/en/pages.md new file mode 100644 index 0000000..20f0ecd --- /dev/null +++ b/_pages/en/pages.md @@ -0,0 +1,9 @@ +--- +altLangPage: /fr/pages +breadcrumbs: + - title: "GCWeb Jekyll" + link: "/en/index" +dateModified: 2021-06-31 +description: +title: Page creation +--- \ No newline at end of file diff --git a/_pages/en/settings.md b/_pages/en/settings.md new file mode 100644 index 0000000..6347945 --- /dev/null +++ b/_pages/en/settings.md @@ -0,0 +1,382 @@ +--- +altLangPage: /fr/personnalisation +breadcrumbs: + - title: GCWeb Jekyll + link: /en/index +dateModified: 2021-06-31 +description: +title: Settings +--- +Customize your website layout, titles and more. The settings file can be found in `_config.yml`. + +## Site settings + +The general settings have to be set in `_config.yml`. + +> **Important**: The minimum requirement to configure your website, would be to set the `remote_theme: WET-BOEW/gcweb-jekyll` in your config file + +### `site-description` + +Type: *dictionary* + +The website description is used for SEO purposes only. + +Example: + +```yml +# _config.yml + +site-description: + en: A reference implementation of the Canada.ca Content and Information Architecture Specification, the Canada.ca Content Style Guide and the Canada.ca Design System. + fr: "Une mise en œuvre de référence de la spécification de l'architecture du contenu et de l'information de Canada.ca, du guide de style de contenu de Canada.ca et du système de conception de Canada.ca." +``` + +### `title` + +Type: *string* + +The website title is used for SEO purposes and set the home page title. + +Example: + +```yml +# _config.yml + +title: GCWeb Jekyll | A remote Jekyll theme with the Canada.ca theme. +``` + + +## Page settings + +The page settings have to be set in the Front Matter of the page content + +> **Important**: Some settings could be set as default in the `_config.yml` file + +### `altLangPage` + +Type: *string* + +The altLangPage file path is used to enable the link in the language toggle for the translation of the alternate page content. If omitted, the link in the language won't be added in the header. + +Example: + +```yml +# page.md + +--- +altLangPage: /fr/page +--- +``` + +### `breadcrumbs` + +Type: *array* + +The breadcrumbs items are used to enable the links in the breadcrumbs. A title and an absolute url for each breadcrumb is required. + +Example: +```yml +# page.md + +--- +breadcrumbs: + - title: Canada.ca + link: https://www.canada.ca/en +--- +``` + +### `css` + +Type: *string* or *array* + +The css file path is used to attach custom stylesheets to your page. If you have more than one stylesheets to attach use the array format to declare them, otherwise the string format can be used if you only have one stylesheet to attach. + +Example: +```yml +# page.md + +--- +css: + - /path/to/stylesheet1 + - /path/to/stylesheet2 + - ... +--- +``` + +### `dateModified` + +Type: *date* + +The date is used to specified the last modification date of the page in ISO format, AAAA-MM-DD. + +Example: + +```yml +# page.md + +--- +dateModified: 2021-07-01 +--- +``` + +## `description` + +Type: *string* + +The page description is used for SEO purpose only. As its value cannot be zero, if it is not defined in the page, the site description will be used instead. + +Example: + +```yml +# page.md + +--- +description: Page description for SEO +--- +``` + +### `lang` + +Type: *string* + +The lang property is used to specifiy the language of the page content. By default the template support "en" for English and "fr" for French. + +Example: + +```yml +# page.md + +--- +lang: en +--- +``` + +### `layout` + +Type: _string_ + +The page layout is used to define the page template to use. There's eight templates that can be called from your page: + +- *core** +- *default* +- *fluid* +- *layout-home* +- *layout-servermessage* +- *layout-splashpage* +- *no-container* +- *without-h1* + +\* The core template should be used to create other templates. + +Example: + +```yml +# page.md + +--- +layout: default +--- +``` + +### `nofooter` + +Type: *bolean* + +The nofooter setting is used to disable the global site footer when set to true. If the global site footer is disabled, the skiplinks will be adjusted accordingly. + +Example: +```yml +# page.md + +--- +nofooter: true +--- +``` + +### `pageclass` + +Type: *string* + +* splash +* page-type-nav +* cnt-wdth-lmtd +* page-type-search +* theme + +Example: +```yml +# page.md + +--- +pageclass: cnt-wdth-lmtd +--- +``` + +### `pageType` + +Type: *string* + +* advance service +* archived +* gcaudience +* institution +* news +* organization +* theme +* topic + +Example: +```yml +# page.md + +--- +pageType: archived +--- +``` + +### `script` + +Type: *string* or *array* + +The css file path is used to attach custom scripts to your page. If you have more than one script files to attach use the array format to declare them, otherwise the string format can be used if you only have one script file to attach. + +Example: +```yml +# page.md + +--- +script: + - /path/to/script1 + - /path/to/script2 + - ... +--- +``` + +### `title` + +Type: *string* + +Example: +```yml +# page.md + +--- +title: Title of the website or webpage +--- +``` + +### `titleH1` + +Type: *string* + +Example: +```yml +# page.md + +--- +titleH1: Text to override the title of the webpge in the H1 +--- +``` + +## `layout-splashpage` settings + +### `creator-en` + +Type: *string* + +The creator-en is used for SEO purpose only and set the page creator English name. + +```yml +# index.md + +--- +creator-en: Department name +layout: layout-splashpage +--- +``` + +### `creator-fr` + +Type: *string* + +The creator-en is used for SEO purpose only and set the page creator French name. + +Example: +```yml +# index.md + +--- +creator-fr: Nom du ministère +layout: layout-splashpage +--- +``` + +### `dateIssued` + +Type: *date* + +Example: +```yml +# index.md + +--- +dateIssued: 2021-07-01 +layout: layout-splashpage +--- +``` + +### `description-en` + +Type: *string* + +Example: +```yml +# index.md + +--- +description-en: Page description for SEO +layout: layout-splashpage +--- +``` + +### `description-fr` + +Type: *string* + +Example: +```yml +# index.md + +--- +description-fr: Description de la page pour fins de référencement +layout: layout-splashpage +--- +``` + +### `subject-en` + +Type: *string* + +Example: +```yml +# index.md + +--- +subject-en: topic1, topic2, topic3, ... +layout: layout-splashpage +--- +``` + +### `subject-fr` + +Type: *string* + +Examples: +```yml +# index.md + +--- +subject-fr: sujet1, sujet2, sujet3, ... +layout: layout-splashpage +--- +``` \ No newline at end of file diff --git a/_pages/en/setup.md b/_pages/en/setup.md new file mode 100644 index 0000000..9a6220e --- /dev/null +++ b/_pages/en/setup.md @@ -0,0 +1,50 @@ +--- +altLangPage: /fr/configuration +breadcrumbs: + - title: "GCWeb Jekyll" + link: "/en/index" +dateModified: 2021-06-31 +description: +title: Setup +--- +## Environment +Before starting, make sure you have [Ruby](https://www.ruby-lang.org/en/documentation/installation/) and [NodeJS](https://nodejs.org/) installed. + +Then install Jekyll: +``` +$ gem install jekyll +``` + +## Installing the template + +1. Create a repo for your project: +``` +$ git init https://github.com// +``` + +2. Access the local project: +``` +$ cd path/to/your-project-name +``` + +3. Set the _config.yml to call the gcweb-jekyll theme + +``` +remote_theme: wet-boew/gcweb-jekyll +``` + +4. Build Jekyll: +``` +$ bundle exec jekyll build +``` + +## Running local +After the steps above, to run Jekyll locally, ...: +``` +$ bundle exec jekyll serve +``` + +## Customization +Jekflix Template allows you to personalize your site with several settings. Read the [docs](settings.html) for more details. + +For advanced theme customization, check the [GCWeb repo](https://github.com/wet-boew/GCWeb) for style files. \ No newline at end of file diff --git a/_pages/en/test-page.md b/_pages/en/test-page.md new file mode 100644 index 0000000..8c2132a --- /dev/null +++ b/_pages/en/test-page.md @@ -0,0 +1,126 @@ +--- +altLangPrefix: /fr/page-test +dateModified: 2020-01-10 +description: "Get quick, easy access to all Government of Canada services and information." +pageclass: wb-prettify all-pre +subject: [GV Government and Politics, Government services] +title: Test page - Canada.ca +--- + +This is a normal paragraph following a header. GitHub is a code hosting platform for version control and collaboration. It lets you and others work together on projects from anywhere. + +Text can be **bold**, _italic_, or ~~strikethrough~~. + +[Link to another page](./another-page-test.html). + +There should be whitespace between paragraphs. + +There should be whitespace between paragraphs. We recommend including a README, or a file with information about your project. + +## Header 2 + +> This is a blockquote following a header. +> +> When something is important enough, you do it even if the odds are not in your favor. + +### Header 3 + +```js +// Javascript code with syntax highlighting. +var fun = function lang(l) { + dateformat.i18n = require('./lang/' + l) + return true; +} +``` + +```ruby +# Ruby code with syntax highlighting +GitHubPages::Dependencies.gems.each do |gem, version| + s.add_dependency(gem, "= #{version}") +end +``` + +#### Header 4 + +* This is an unordered list following a header. +* This is an unordered list following a header. +* This is an unordered list following a header. + +##### Header 5 + +1. This is an ordered list following a header. +2. This is an ordered list following a header. +3. This is an ordered list following a header. + +###### Header 6 + +| head1 | head two | three | +|:-------------|:------------------|:------| +| ok | good swedish fish | nice | +| out of stock | good and plenty | nice | +| ok | good `oreos` | hmm | +| ok | good `zoute` drop | yumm | + +### There's a horizontal rule below this. + +* * * + +### Here is an unordered list: + +* Item foo +* Item bar +* Item baz +* Item zip + +### And an ordered list: + +1. Item one +1. Item two +1. Item three +1. Item four + +### And a nested list: + +- level 1 item + - level 2 item + - level 2 item + - level 3 item + - level 3 item +- level 1 item + - level 2 item + - level 2 item + - level 2 item +- level 1 item + - level 2 item + - level 2 item +- level 1 item + +### Small image + +![Octocat](https://github.githubassets.com/images/icons/emoji/octocat.png) + +### Large image + +![Branching](https://guides.github.com/activities/hello-world/branching.png){: .img-responsive} + + +### Definition lists can be used with HTML syntax. + +
+
Name
+
Godzilla
+
Born
+
1952
+
Birthplace
+
Japan
+
Color
+
Green
+
+ +``` +Long, single-line code blocks should not wrap. They should horizontally scroll if they are too long. This line should be long enough to demonstrate this. +``` + +``` +The final element. +``` \ No newline at end of file diff --git a/_pages/en/translation.md b/_pages/en/translation.md new file mode 100644 index 0000000..30b6955 --- /dev/null +++ b/_pages/en/translation.md @@ -0,0 +1,42 @@ +--- +altLangPage: /fr/traductions +breadcrumbs: + - title: "GCWeb Jekyll" + link: "/en/index" +dateModified: 2021-06-31 +description: +title: Translations +--- +## Translations +In order to translate texts throughout the theme, modify the i18n-core.liquid file in the '_includes' folder and add the settings below. + +``` +%- elsif i18nText-lang == "en" -%\ + + % assign i18nText-skipCont = "Skip to main content" % + % assign i18nText-skipAbout = "Skip to About this site" % + % assign i18nText-skipSection = "Skip to section menu" % + + % assign i18nText-altLang = "fr" % + % assign i18nText-altLanguage = "Français" % + + % assign i18nText-search = "Search" % + + % assign i18nText-breadcrumb = "You are here:" % + % assign i18nText-language = "Language selection" % + + % assign i18nText-menu = "Menu" % + % assign i18nText-menuBtn = 'Main Menu' % + + % assign i18nText-signOnOff = "Sign-on information" % + % assign i18nText-signOnRegister = "Register" % + % assign i18nText-signIn = "Sign in" % + % assign i18nText-signAs = "Signed in as" % + % assign i18nText-signOut = "Sign out" % + % assign i18nText-signAccount = "My account" % + + % assign i18nText-footerSite = "About this site" % + % assign i18nText-top = "Top of Page" % + + % assign i18nText-dateModified = "Date modified:" % +``` \ No newline at end of file diff --git a/api-publique.md b/_pages/fr/api-publique.md similarity index 100% rename from api-publique.md rename to _pages/fr/api-publique.md diff --git a/_pages/fr/autre-page-test.md b/_pages/fr/autre-page-test.md new file mode 100644 index 0000000..32ae2e1 --- /dev/null +++ b/_pages/fr/autre-page-test.md @@ -0,0 +1,12 @@ +--- +altLangPrefix: another-page +dateModified: 2020-01-08 +description: Ceci est juste une autre page +title: Autre page +--- + +## Bienvenue sur une autre page + +_Yé_ + +[retour](./page-test.html) diff --git a/_pages/fr/autre-page.md b/_pages/fr/autre-page.md deleted file mode 100644 index 886a847..0000000 --- a/_pages/fr/autre-page.md +++ /dev/null @@ -1,19 +0,0 @@ ---- -altLangPrefix: another-page -dateModified: 2020-01-08 -description: - fr: Ceci est juste une autre page -footer: true -langtoggle: true -lang: fr -noMainContainer: false -sitemenu: true -sitesearch: true -title: Autre page ---- - -## Bienvenue sur une autre page - -_Yé_ - -[retour](./) diff --git a/_pages/fr/configuration.md b/_pages/fr/configuration.md new file mode 100644 index 0000000..6b86fed --- /dev/null +++ b/_pages/fr/configuration.md @@ -0,0 +1,53 @@ +--- +altLangPage: /en/setup +breadcrumbs: + - title: "GCWeb Jekyll" + link: "/fr/index" +dateModified: 2021-06-31 +description: +title: Configuration +--- + +## Environment + +Avant de commencer, assurez-vous d'avoir [Ruby](https://www.ruby-lang.org/en/documentation/installation/) et [NodeJS](https://nodejs.org/) d'installer. + +Puis installer Jekyll: + +``` +$ gem install jekyll +``` + +## Installer le gabarit + +1. Créez un dépôt pour votre projet : + +``` +$ git init https://github.com// +``` + +2. Accéder à votre projet localement : + +``` +$ cd chemin/daccess/au/nom-du-projet +``` + +3. Exécuter Jekyll: + +``` +$ bundle exec jekyll build +``` + +## Rouler localement + +Après les étapes ci-dessus, pour exécuter Jekyll localement, ...: + +``` +$ bundle exec jekyll serve +``` + +## Personnalisation + +Le gabarit GCWeb-Jekyll vous permet de personnaliser votre site avec plusieurs paramètres. Lisez la [documentation](personnalisation.html) pour plus de détails. + +Pour une personnalisation avancée du thème, consultez le [dépôt GCWeb](https://github.com/wet-boew/GCWeb) pour les fichiers de style. \ No newline at end of file diff --git a/_pages/fr/gh-pages.md b/_pages/fr/gh-pages.md new file mode 100644 index 0000000..a241f38 --- /dev/null +++ b/_pages/fr/gh-pages.md @@ -0,0 +1,9 @@ +--- +altLangPage: /en/gh-pages +breadcrumbs: + - title: "GCWeb Jekyll" + link: "/fr/index" +dateModified: 2021-06-31 +description: +title: Pages GitHub +--- \ No newline at end of file diff --git a/_pages/fr/index.md b/_pages/fr/index.md index 527decb..8bb714f 100644 --- a/_pages/fr/index.md +++ b/_pages/fr/index.md @@ -1,138 +1,46 @@ --- -altLangPrefix: index -authorName: Service Canada -authorUrl: -contentTitle: Canada.ca Jekyll theme +altLangPage: /en/index +dateModified: 2021-06-31 description: - en: "Get quick, easy access to all Government of Canada services and information." - fr: "Accédez rapidement et facilement à tous les services et renseignements du gouvernement du Canada." lang: fr -#layout: page -layout: default -noContentTitle: true -pageclass: wb-prettify all-pre -subject: - en: [GV Government and Politics, Government services] - fr: [GV Gouvernement et vie politique, Services gouvernementaux] -title: Test page - Canada.ca +layout: layout-home +title: GCWeb Jekyll --- - -# {{ page.contentTitle }} - -Il s'agit d'un paragraphe normal suivant un en-tête. GitHub est une plateforme d'hébergement de code pour le contrôle de version et la collaboration. Il vous permet, ainsi qu'à d'autres, de travailler ensemble sur des projets de n'importe où. - -Le texte peut être **gras**, _italique_ ou ~~barré~~. - -[Lien vers une autre page](./autre-page.html). - -Il devrait y avoir un espace entre les paragraphes. - -Il devrait y avoir un espace entre les paragraphes. Nous vous recommandons d'inclure un fichier README ou un fichier contenant des informations sur votre projet. - -## En-tête 2 - -> Il s'agit d'une citation suivant un en-tête. -> -> Lorsque quelque chose est suffisamment important, vous le faites même si les chances ne sont pas en votre faveur. - -### En-tête 3 - -```js -// Code Javascript avec coloration syntaxique. -var fun = function lang(l) { - dateformat.i18n = require('./lang/' + l) - return true; -} -``` - -```ruby -# Code Ruby avec coloration syntaxique -GitHubPages::Dependencies.gems.each do |gem, version| - s.add_dependency(gem, "= #{version}") -end -``` - -#### En-tête 4 - -* Il s'agit d'une liste non ordonnée suivant un en-tête. -* Il s'agit d'une liste non ordonnée suivant un en-tête. -* Il s'agit d'une liste non ordonnée suivant un en-tête. - -##### En-tête 5 - -1. Il s'agit d'une liste ordonnée suivant un en-tête. -2. Il s'agit d'une liste ordonnée suivant un en-tête. -3. Il s'agit d'une liste ordonnée suivant un en-tête. - -###### En-tête 6 - -| head1 | tête deux | trois | -|:----------------|:------------------|:------| -| ok | bon poisson suédois | sympa | -| en rupture de stock | bon et plein | sympa | -| ok | bon `oreos` | hmm | -| ok | bonne goutte `zoute` | miam | - -### Il y a une ligne horizontale en dessous. - -* * * - -### Voici une liste non ordonnée: - -* Objet foo -* Barre d'articles -* Article baz -* Article zip - -### Et une liste ordonnée: - -1. Point un -1. Point deux -1. Point trois -1. Point quatre - -### Et une liste imbriquée: - -- élément de niveau 1 -   - objet de niveau 2 -   - objet de niveau 2 -     - objet de niveau 3 -     - objet de niveau 3 -- élément de niveau 1 -   - objet de niveau 2 -   - objet de niveau 2 -   - objet de niveau 2 -- élément de niveau 1 -   - objet de niveau 2 -   - objet de niveau 2 -- élément de niveau 1 - -### Petite image - -![Octocat](https://github.githubassets.com/images/icons/emoji/octocat.png) - -### Grande image - -![Branching](https://guides.github.com/activities/hello-world/branching.png){: .img-responsive} - - -### Les listes de définitions peuvent être utilisées avec la syntaxe HTML. - -
-
Nom
-
Godzilla
-
Né
-
1952
-
Lieu de naissance
-
Japon
-
Couleur
-
Vert
-
- -``` -Les longs blocs de code sur une seule ligne ne doivent pas être bouclés. Ils doivent défiler horizontalement s'ils sont trop longs. Cette ligne doit être suffisamment longue pour le démontrer. -``` - -``` -Le dernier élément. -``` \ No newline at end of file +
+
+
+

GCWeb Jekyll

+

Bienvenue sur le site du gabarit Jekyll de GCWeb

+
+
+
+
+
+

En demande

+ +
+
+
+

Services et renseignements

+
+
+

Configuration

+

Configurer votre environnement local et installer le gabarit.

+
+
+

Personnalisation

+

Personnaliser votre site Web, changer la mise en page, le titre, etc.

+
+
+

Pages

+

Créer des pages et utiliser les propriétés Front Matter

+
+
+

Pages GitHub

+

Déployer votre site Web en utilisant gh-pages et éditez votre contenu.

+
+
\ No newline at end of file diff --git a/_pages/fr/page-test.md b/_pages/fr/page-test.md new file mode 100644 index 0000000..ee0c3e7 --- /dev/null +++ b/_pages/fr/page-test.md @@ -0,0 +1,125 @@ +--- +altLangPrefix: index +description: "Accédez rapidement et facilement à tous les services et renseignements du gouvernement du Canada." +pageclass: wb-prettify all-pre +subject: [GV Gouvernement et vie politique, Services gouvernementaux] +title: Test page - Canada.ca +--- + +Il s'agit d'un paragraphe normal suivant un en-tête. GitHub est une plateforme d'hébergement de code pour le contrôle de version et la collaboration. Il vous permet, ainsi qu'à d'autres, de travailler ensemble sur des projets de n'importe où. + +Le texte peut être **gras**, _italique_ ou ~~barré~~. + +[Lien vers une autre page](./autre-page-test.html). + +Il devrait y avoir un espace entre les paragraphes. + +Il devrait y avoir un espace entre les paragraphes. Nous vous recommandons d'inclure un fichier README ou un fichier contenant des informations sur votre projet. + +## En-tête 2 + +> Il s'agit d'une citation suivant un en-tête. +> +> Lorsque quelque chose est suffisamment important, vous le faites même si les chances ne sont pas en votre faveur. + +### En-tête 3 + +```js +// Code Javascript avec coloration syntaxique. +var fun = function lang(l) { + dateformat.i18n = require('./lang/' + l) + return true; +} +``` + +```ruby +# Code Ruby avec coloration syntaxique +GitHubPages::Dependencies.gems.each do |gem, version| + s.add_dependency(gem, "= #{version}") +end +``` + +#### En-tête 4 + +* Il s'agit d'une liste non ordonnée suivant un en-tête. +* Il s'agit d'une liste non ordonnée suivant un en-tête. +* Il s'agit d'une liste non ordonnée suivant un en-tête. + +##### En-tête 5 + +1. Il s'agit d'une liste ordonnée suivant un en-tête. +2. Il s'agit d'une liste ordonnée suivant un en-tête. +3. Il s'agit d'une liste ordonnée suivant un en-tête. + +###### En-tête 6 + +| head1 | tête deux | trois | +|:----------------|:------------------|:------| +| ok | bon poisson suédois | sympa | +| en rupture de stock | bon et plein | sympa | +| ok | bon `oreos` | hmm | +| ok | bonne goutte `zoute` | miam | + +### Il y a une ligne horizontale en dessous. + +* * * + +### Voici une liste non ordonnée: + +* Objet foo +* Barre d'articles +* Article baz +* Article zip + +### Et une liste ordonnée: + +1. Point un +1. Point deux +1. Point trois +1. Point quatre + +### Et une liste imbriquée: + +- élément de niveau 1 +   - objet de niveau 2 +   - objet de niveau 2 +     - objet de niveau 3 +     - objet de niveau 3 +- élément de niveau 1 +   - objet de niveau 2 +   - objet de niveau 2 +   - objet de niveau 2 +- élément de niveau 1 +   - objet de niveau 2 +   - objet de niveau 2 +- élément de niveau 1 + +### Petite image + +![Octocat](https://github.githubassets.com/images/icons/emoji/octocat.png) + +### Grande image + +![Branching](https://guides.github.com/activities/hello-world/branching.png){: .img-responsive} + + +### Les listes de définitions peuvent être utilisées avec la syntaxe HTML. + +
+
Nom
+
Godzilla
+
Né
+
1952
+
Lieu de naissance
+
Japon
+
Couleur
+
Vert
+
+ +``` +Les longs blocs de code sur une seule ligne ne doivent pas être bouclés. Ils doivent défiler horizontalement s'ils sont trop longs. Cette ligne doit être suffisamment longue pour le démontrer. +``` + +``` +Le dernier élément. +``` \ No newline at end of file diff --git a/_pages/fr/pages.md b/_pages/fr/pages.md new file mode 100644 index 0000000..836d8b6 --- /dev/null +++ b/_pages/fr/pages.md @@ -0,0 +1,9 @@ +--- +altLangPage: /en/pages +breadcrumbs: + - title: "GCWeb Jekyll" + link: "/fr/index" +dateModified: 2021-06-31 +description: +title: Création de pages +--- \ No newline at end of file diff --git a/_pages/fr/personnalisation.md b/_pages/fr/personnalisation.md new file mode 100644 index 0000000..6a11c94 --- /dev/null +++ b/_pages/fr/personnalisation.md @@ -0,0 +1,174 @@ +--- +altLangPage: /en/settings +breadcrumbs: + - title: "GCWeb Jekyll" + link: "/fr/index" +dateModified: 2021-06-31 +description: +title: Personnalisation +--- +Personnalisez la mise en page de votre site Web, les titres et plus encore. Les paramètres se trouvent dans le fichier `_config.yml`. + +## Paramètres du site + +Les paramètres généraux doivent être définis dans `_config.yml`. + +> **Important** : La configuration minimale requise pour configurer votre site Web serait de définir le `remote_theme: WET-BOEW/gcweb-jekyll` dans votre fichier de configuration + +### `site-description` + +Type : *dictionaire* + +La description du site Web est utilisée uniquement à des fins de référencement (SEO). + +Exemple : + +```yml +# _config.yml + +site-description: + en: A reference implementation of the Canada.ca Content and Information Architecture Specification, the Canada.ca Content Style Guide and the Canada.ca Design System. + fr: "Une mise en œuvre de référence de la spécification de l'architecture du contenu et de l'information de Canada.ca, du guide de style de contenu de Canada.ca et du système de conception de Canada.ca." +``` + +### `title` + +Type : *chaîne de caractères* + +Le titre du site Web est utilisé à des fins de référencement (SEO) et définit le titre de la page d'accueil. + +Exemple : + +```yml +# _config.yml + +title: GCWeb Jekyll | Un thème Jekyll à distance avec le thème Canada.ca. +``` + + +## Paramètres de la page + +Les paramètres de la page doivent être définis dans le Front Matter du contenu de la page + +> **Important** : Certains de ces paramètres peuvent être définis par défaut dans le fichiers `_config.yml`. + +### `altLangPage` + +Type : *chaîne de caractères* + +Le chemin du fichier altLangPage est utilisé pour activer le lien dans la bascule de langue pour la traduction du contenu de la page alternative. S'il est omis, le lien dans la langue ne sera pas ajouté dans l'en-tête. + +Exemple : + +```yml +# page.md + +--- +altLangPage: /fr/page +--- +``` + +### `breadcrumbs` + +Type: *tableau* + +Les items dans la propriété breadcrumbs est utilisé pour activer les liens dans le fil d'Arianne. Un titre et un lien absolu est requis pour chaque item. + +```yml +# page.md + +--- +breadcrumbs: + - title: Canada.ca + link: https://www.canada.ca/fr +--- +``` + +### `css` + +Type: *chaîne de caractères* ou *tableau* + +Le chemin des fichiers css est utilisé pour ajouter des feuilles de style personalisées à votre page. Si vous avez plus d'une feuille à ajouter, utilisez un tableau pour les déclarer, sinon le format de chaìne de caractères peut être utilisé si il n'y a qu'une seule feuille de style à ajouter. + +Example: +```yml +# page.md + +--- +css: + - /chemin/du/fichier/de/la/feuile-de-style1 + - /chemin/du/fichier/de/la/feuile-de-style2 + - ... +--- +``` + +### `dateModified` + +Type : *date* + +La date permet de préciser la date de dernière modification de la page au format ISO, AAAA-MM-JJ. + +Exemple: + +```yml +# page.md + +--- +dateModified: 2021-07-01 +--- +``` + +### `description` + +Type : *chaîne de caractères* + +La description de la page est est utilisée uniquement à des fins de référencement (SEO). Comme sa valeur ne peut être nulle, si elle n'est pas définie dans la page, la description du site sera utilsé. + +```yml +# page.md + +--- +description: Description de la page pour fins de référencement +--- +``` + +### `lang` + +Type : *chaîne de caractères* + +La propriété lang est utilisée pour spécifier la langue du contenu de la page. Par défaut, le modèle prend en charge "en" pour l'anglais et "fr" pour le français. + +Exemple : + +```yml +# page.md + +--- +lang: fr +--- +``` + +### `layout` + +Type : _chaîne de caractères_ + +La mise en page permet de définir le modèle de page à utiliser. Huit modèles peuvent être appelés à partir de votre page : + +- *core* +- *default* +- *fluid* +- *layout-home* +- *layout-servermessage* +- *layout-splashpage* +- *no-container* +- *without-h1* + +Exemple : + +```yml +# page.md + +--- +layout: défault +--- +``` \ No newline at end of file diff --git a/_pages/fr/traductions.md b/_pages/fr/traductions.md new file mode 100644 index 0000000..f15febf --- /dev/null +++ b/_pages/fr/traductions.md @@ -0,0 +1,9 @@ +--- +altLangPage: /en/translations +breadcrumbs: + - title: "GCWeb Jekyll" + link: "/en/index" +dateModified: 2021-06-31 +description: +title: Traductions +--- \ No newline at end of file