From 6d9f76fdccfa4aa16dbb8b1fa1e12cb822afb0ef Mon Sep 17 00:00:00 2001 From: Hakisho Nukama Date: Tue, 10 Mar 2015 23:55:37 +0000 Subject: [PATCH] added `jekyll new` site --- CNAME | 1 + README.md | 2 +- _author | 1 - _config.yml | 40 ++++++ _data/wiki.yml | 11 ++ _includes/footer.html | 55 ++++++++ _includes/hcl-cell.html | 10 ++ _includes/hcl-color.css | 11 ++ _includes/hcl-device.html | 34 +++++ _includes/hcl-item.html | 54 ++++++++ _includes/hcl-version.html | 9 ++ _includes/head.html | 16 +++ _includes/header.html | 37 +++++ _includes/nav-wiki.html | 11 ++ _layouts/default.html | 20 +++ _layouts/page.html | 14 ++ _layouts/post.html | 15 ++ _layouts/wiki.html | 22 +++ _sass/_base.scss | 204 +++++++++++++++++++++++++++ _sass/_layout.scss | 236 ++++++++++++++++++++++++++++++++ _sass/_syntax-highlighting.scss | 67 +++++++++ css/main.scss | 52 +++++++ favicon.ico | 1 + favicon.png | 1 + feed.xml | 30 ++++ freenode.txt | 0 help.md | 40 ++++++ 27 files changed, 992 insertions(+), 2 deletions(-) create mode 100644 CNAME delete mode 160000 _author create mode 100644 _config.yml create mode 100644 _data/wiki.yml create mode 100644 _includes/footer.html create mode 100644 _includes/hcl-cell.html create mode 100644 _includes/hcl-color.css create mode 100644 _includes/hcl-device.html create mode 100644 _includes/hcl-item.html create mode 100644 _includes/hcl-version.html create mode 100644 _includes/head.html create mode 100644 _includes/header.html create mode 100644 _includes/nav-wiki.html create mode 100644 _layouts/default.html create mode 100644 _layouts/page.html create mode 100644 _layouts/post.html create mode 100644 _layouts/wiki.html create mode 100644 _sass/_base.scss create mode 100644 _sass/_layout.scss create mode 100644 _sass/_syntax-highlighting.scss create mode 100755 css/main.scss create mode 120000 favicon.ico create mode 120000 favicon.png create mode 100644 feed.xml create mode 100644 freenode.txt create mode 100644 help.md diff --git a/CNAME b/CNAME new file mode 100644 index 00000000..733c2d68 --- /dev/null +++ b/CNAME @@ -0,0 +1 @@ +www.qubes-os.org diff --git a/README.md b/README.md index 5f7a5fd9..6dc8d392 100644 --- a/README.md +++ b/README.md @@ -15,5 +15,5 @@ Use `git clone --recursive` to check out submodules, too. # Running jekyll on your localhost -Run `jekyll s -V --trace (--skip-initial)`. +Run `jekyll s --safe -V --trace (--skip-initial)`. diff --git a/_author b/_author deleted file mode 160000 index 03770a73..00000000 --- a/_author +++ /dev/null @@ -1 +0,0 @@ -Subproject commit 03770a73fa800eb97325da46987207bc8df426dc diff --git a/_config.yml b/_config.yml new file mode 100644 index 00000000..6344afd8 --- /dev/null +++ b/_config.yml @@ -0,0 +1,40 @@ +# Site settings +title: Qubes OS Project +#email: your-email@domain.com +description: > # this means to ignore newlines until "baseurl:" + Qubes OS is an open source operating system designed to provide strong + security for desktop computing using Security by Compartmentalization + approach. + Qubes is based on Xen, X Window System, and Linux, and can run most + Linux applications and utilize most of the Linux drivers. + It can also run Windows apps natively in Windows AppVMs (Beta). +#baseurl: "" # the subpath of your site, e.g. /blog/ +#url: "https://www.qubes-os.org" # the base hostname & protocol for your site +#twitter_username: +github_username: QubesOS +# Project Settings +project_url: "https://www.qubes-os.org" +project_repo_path: "https://github.com/QubesOS" +project_repo_site: "/qubesos.github.io" +project_repo_wiki: "/qubes-wiki" +project_repo_artwork: "/qubes-artwork" + + +# Build settings +markdown: kramdown +highlighter: pygments +timezone: UTC +encoding: utf-8 +relative_permalinks: false +permalink: /news/:year/:month/:day/:title/ +excerpt_separator: "" +gems: + - jekyll-redirect-from + +collections: +# docs: +# output: true + wiki: + output: true + hcl: + output: true diff --git a/_data/wiki.yml b/_data/wiki.yml new file mode 100644 index 00000000..bf6fc7b4 --- /dev/null +++ b/_data/wiki.yml @@ -0,0 +1,11 @@ +- title: Qubes OS + wiki: + - QubesDownloads + - QubesScreenshots + - QubesSecurity + - QubesDocs + - QubesLists + - QubesLicensing + - QubesDevelopers + - Donations + - QubesContacts diff --git a/_includes/footer.html b/_includes/footer.html new file mode 100644 index 00000000..cc01e001 --- /dev/null +++ b/_includes/footer.html @@ -0,0 +1,55 @@ + diff --git a/_includes/hcl-cell.html b/_includes/hcl-cell.html new file mode 100644 index 00000000..c144468b --- /dev/null +++ b/_includes/hcl-cell.html @@ -0,0 +1,10 @@ +{% if include.param %} + {% assign value = include.param %} +{% else %} + {% assign value = 'unknown' %} +{% endif %} + + + {{ value }} + + diff --git a/_includes/hcl-color.css b/_includes/hcl-color.css new file mode 100644 index 00000000..acdfc465 --- /dev/null +++ b/_includes/hcl-color.css @@ -0,0 +1,11 @@ +{% case include.value %} +{% when 'yes' %} + green +{% when 'partial' %} + yellow +{% when 'no' %} + red +{% else %} + blue; +{% endcase %} + diff --git a/_includes/hcl-device.html b/_includes/hcl-device.html new file mode 100644 index 00000000..0e1f76b1 --- /dev/null +++ b/_includes/hcl-device.html @@ -0,0 +1,34 @@ +{% assign rowspan = device.versions | size %} +{% assign range = rowspan | minus:1 %} + +{% if rowspan > 1 %} + {% capture rowspan %} rowspan="{{ rowspan }}"{% endcapture %} +{% endif %} + + + + {{ device.brand }} {{ device.model }}
+ ({{ device.cpu-short }} {{ device.chipset-short }} + {{ device.gpu-short }}) + + {{ device.bios }} + + {% assign param=device.hvm %} + {% include hcl-cell.html param=param rowspan=rowspan %} + + {% assign param=device.iommu %} + {% include hcl-cell.html param=param rowspan=rowspan %} + + {% assign param=device.tpm %} + {% include hcl-cell.html param=param rowspan=rowspan %} + +{% assign version = device.versions[0] %} +{% include hcl-version.html version=version %} + + +{% for i in (1..range) %} + + {% assign version = device.versions[i] %} + {% include hcl-version.html version=version %} + +{% endfor %} diff --git a/_includes/hcl-item.html b/_includes/hcl-item.html new file mode 100644 index 00000000..45a9a72c --- /dev/null +++ b/_includes/hcl-item.html @@ -0,0 +1,54 @@ + {% assign rowspan = hcl.versions | size %} + + {{ hcl.model }} + + {{ hcl.hvm }} + + + {{ hcl.iommu }} + + {{ hcl.kernel }} + {{ hcl.xen }} + {{ hcl.memory }} + {{ hcl.cpu }} + {{ hcl.credit }} + + {% case hcl.versions[0].works %} + {% when true %} + {% assign background = 'green' %} + {% when 'maybe' %} + {% assign background = 'yellow' %} + {% else %} + {% assign background = 'red' %} + {% endcase %} + + {{ hcl.versions[0].qubes }} + {{ hcl.versions[0].xen }} + {{ hcl.versions[0].kernel }} + {{ hcl.versions[0].remark }} + {{ hcl.versions[0].credit }} + + + {% assign range = rowspan | minus:1 %} + {% for i in (1..range) %} + {% case hcl.versions[i].works %} + {% when true %} + {% assign background = 'green' %} + {% when 'maybe' %} + {% assign background = 'yellow' %} + {% else %} + {% assign background = 'red' %} + {% endcase %} + + + {{ hcl.versions[i].qubes }} + {{ hcl.versions[i].xen }} + {{ hcl.versions[i].kernel }} + {{ hcl.versions[i].remark }} + {{ hcl.versions[i].credit }} + + {% endfor %} diff --git a/_includes/hcl-version.html b/_includes/hcl-version.html new file mode 100644 index 00000000..7a0d5d13 --- /dev/null +++ b/_includes/hcl-version.html @@ -0,0 +1,9 @@ +{% assign value = include.version.works %} +{% capture background %}{% include hcl-color.css value=value %}{% endcapture %} + +{{ include.version.qubes }} +{{ include.version.xen }} +{{ include.version.kernel }} +{{ include.version.remark }} +{{ include.version.credit }} + diff --git a/_includes/head.html b/_includes/head.html new file mode 100644 index 00000000..4998dbc4 --- /dev/null +++ b/_includes/head.html @@ -0,0 +1,16 @@ + + + + + + {% if page.title %}{{ page.title }}{% else %}{{ site.title }}{% endif %} + + + + + + + + + + diff --git a/_includes/header.html b/_includes/header.html new file mode 100644 index 00000000..fb9c7834 --- /dev/null +++ b/_includes/header.html @@ -0,0 +1,37 @@ + diff --git a/_includes/nav-wiki.html b/_includes/nav-wiki.html new file mode 100644 index 00000000..480724e4 --- /dev/null +++ b/_includes/nav-wiki.html @@ -0,0 +1,11 @@ +{% assign items = include.items %} + +{% for item in items %} + {% assign item_url = item | prepend:"/wiki/" | append:"/" %} + + {% for p in site.wiki %} + {% if p.url == item_url %} + {{ p.title }} + {% endif %} + {% endfor %} +{% endfor %} diff --git a/_layouts/default.html b/_layouts/default.html new file mode 100644 index 00000000..e4ab96fb --- /dev/null +++ b/_layouts/default.html @@ -0,0 +1,20 @@ + + + + {% include head.html %} + + + + {% include header.html %} + +
+
+ {{ content }} +
+
+ + {% include footer.html %} + + + + diff --git a/_layouts/page.html b/_layouts/page.html new file mode 100644 index 00000000..8fbc3be7 --- /dev/null +++ b/_layouts/page.html @@ -0,0 +1,14 @@ +--- +layout: default +--- +
+ +
+

{{ page.title }}

+
+ +
+ {{ content }} +
+ +
diff --git a/_layouts/post.html b/_layouts/post.html new file mode 100644 index 00000000..a2b4e52f --- /dev/null +++ b/_layouts/post.html @@ -0,0 +1,15 @@ +--- +layout: default +--- +
+ +
+

{{ page.title }}

+ +
+ +
+ {{ content }} +
+ +
diff --git a/_layouts/wiki.html b/_layouts/wiki.html new file mode 100644 index 00000000..56119d57 --- /dev/null +++ b/_layouts/wiki.html @@ -0,0 +1,22 @@ +--- +layout: default +--- + +
+
+
+ +
+ +
+ +
+
diff --git a/_sass/_base.scss b/_sass/_base.scss new file mode 100644 index 00000000..e5fd0fd8 --- /dev/null +++ b/_sass/_base.scss @@ -0,0 +1,204 @@ +/** + * Reset some basic elements + */ +body, h1, h2, h3, h4, h5, h6, +p, blockquote, pre, hr, +dl, dd, ol, ul, figure { + margin: 0; + padding: 0; +} + + + +/** + * Basic styling + */ +body { + font-family: $base-font-family; + font-size: $base-font-size; + line-height: $base-line-height; + font-weight: 300; + color: $text-color; + background-color: $background-color; + -webkit-text-size-adjust: 100%; +} + + + +/** + * Set `margin-bottom` to maintain vertical rhythm + */ +h1, h2, h3, h4, h5, h6, +p, blockquote, pre, +ul, ol, dl, figure, +%vertical-rhythm { + margin-bottom: $spacing-unit / 2; +} + + + +/** + * Images + */ +img { + max-width: 100%; + vertical-align: middle; +} + + + +/** + * Figures + */ +figure > img { + display: block; +} + +figcaption { + font-size: $small-font-size; +} + + + +/** + * Lists + */ +ul, ol { + margin-left: $spacing-unit; +} + +li { + > ul, + > ol { + margin-bottom: 0; + } +} + + + +/** + * Headings + */ +h1, h2, h3, h4, h5, h6 { + font-weight: 300; +} + + + +/** + * Links + */ +a { + color: $brand-color; + text-decoration: none; + + &:visited { + color: darken($brand-color, 15%); + } + + &:hover { + color: $text-color; + text-decoration: underline; + } +} + + + +/** + * Blockquotes + */ +blockquote { + color: $grey-color; + border-left: 4px solid $grey-color-light; + padding-left: $spacing-unit / 2; + font-size: 18px; + letter-spacing: -1px; + font-style: italic; + + > :last-child { + margin-bottom: 0; + } +} + + + +/** + * Code formatting + */ +pre, +code { + font-size: 15px; + border: 1px solid $grey-color-light; + border-radius: 3px; + background-color: #eef; +} + +code { + padding: 1px 5px; +} + +pre { + padding: 8px 12px; + overflow-x: scroll; + + > code { + border: 0; + padding-right: 0; + padding-left: 0; + } +} + + + +/** + * Wrapper + */ +.wrapper { + max-width: -webkit-calc(#{$content-width} - (#{$spacing-unit} * 2)); + max-width: calc(#{$content-width} - (#{$spacing-unit} * 2)); + margin-right: auto; + margin-left: auto; + padding-right: $spacing-unit; + padding-left: $spacing-unit; + @extend %clearfix; + + @include media-query($on-laptop) { + max-width: -webkit-calc(#{$content-width} - (#{$spacing-unit})); + max-width: calc(#{$content-width} - (#{$spacing-unit})); + padding-right: $spacing-unit / 2; + padding-left: $spacing-unit / 2; + } +} + + + +/** + * Clearfix + */ +%clearfix { + + &:after { + content: ""; + display: table; + clear: both; + } +} + + + +/** + * Icons + */ +.icon { + + > svg { + display: inline-block; + width: 16px; + height: 16px; + vertical-align: middle; + + path { + fill: $grey-color; + } + } +} diff --git a/_sass/_layout.scss b/_sass/_layout.scss new file mode 100644 index 00000000..def56f89 --- /dev/null +++ b/_sass/_layout.scss @@ -0,0 +1,236 @@ +/** + * Site header + */ +.site-header { + border-top: 5px solid $grey-color-dark; + border-bottom: 1px solid $grey-color-light; + min-height: 56px; + + // Positioning context for the mobile navigation icon + position: relative; +} + +.site-title { + font-size: 26px; + line-height: 56px; + letter-spacing: -1px; + margin-bottom: 0; + float: left; + + &, + &:visited { + color: $grey-color-dark; + } +} + +.site-nav { + float: right; + line-height: 56px; + + .menu-icon { + display: none; + } + + .page-link { + color: $text-color; + line-height: $base-line-height; + + // Gaps between nav items, but not on the first one + &:not(:first-child) { + margin-left: 20px; + } + } + + @include media-query($on-palm) { + position: absolute; + top: 9px; + right: 30px; + background-color: $background-color; + border: 1px solid $grey-color-light; + border-radius: 5px; + text-align: right; + + .menu-icon { + display: block; + float: right; + width: 36px; + height: 26px; + line-height: 0; + padding-top: 10px; + text-align: center; + + > svg { + width: 18px; + height: 15px; + + path { + fill: $grey-color-dark; + } + } + } + + .trigger { + clear: both; + display: none; + } + + &:hover .trigger { + display: block; + padding-bottom: 5px; + } + + .page-link { + display: block; + padding: 5px 10px; + } + } +} + + + +/** + * Site footer + */ +.site-footer { + border-top: 1px solid $grey-color-light; + padding: $spacing-unit 0; +} + +.footer-heading { + font-size: 18px; + margin-bottom: $spacing-unit / 2; +} + +.contact-list, +.social-media-list { + list-style: none; + margin-left: 0; +} + +.footer-col-wrapper { + font-size: 15px; + color: $grey-color; + margin-left: -$spacing-unit / 2; + @extend %clearfix; +} + +.footer-col { + float: left; + margin-bottom: $spacing-unit / 2; + padding-left: $spacing-unit / 2; +} + +.footer-col-1 { + width: -webkit-calc(35% - (#{$spacing-unit} / 2)); + width: calc(35% - (#{$spacing-unit} / 2)); +} + +.footer-col-2 { + width: -webkit-calc(20% - (#{$spacing-unit} / 2)); + width: calc(20% - (#{$spacing-unit} / 2)); +} + +.footer-col-3 { + width: -webkit-calc(45% - (#{$spacing-unit} / 2)); + width: calc(45% - (#{$spacing-unit} / 2)); +} + +@include media-query($on-laptop) { + .footer-col-1, + .footer-col-2 { + width: -webkit-calc(50% - (#{$spacing-unit} / 2)); + width: calc(50% - (#{$spacing-unit} / 2)); + } + + .footer-col-3 { + width: -webkit-calc(100% - (#{$spacing-unit} / 2)); + width: calc(100% - (#{$spacing-unit} / 2)); + } +} + +@include media-query($on-palm) { + .footer-col { + float: none; + width: -webkit-calc(100% - (#{$spacing-unit} / 2)); + width: calc(100% - (#{$spacing-unit} / 2)); + } +} + + + +/** + * Page content + */ +.page-content { + padding: $spacing-unit 0; +} + +.page-heading { + font-size: 20px; +} + +.post-list { + margin-left: 0; + list-style: none; + + > li { + margin-bottom: $spacing-unit; + } +} + +.post-meta { + font-size: $small-font-size; + color: $grey-color; +} + +.post-link { + display: block; + font-size: 24px; +} + + + +/** + * Posts + */ +.post-header { + margin-bottom: $spacing-unit; +} + +.post-title { + font-size: 42px; + letter-spacing: -1px; + line-height: 1; + + @include media-query($on-laptop) { + font-size: 36px; + } +} + +.post-content { + margin-bottom: $spacing-unit; + + h2 { + font-size: 32px; + + @include media-query($on-laptop) { + font-size: 28px; + } + } + + h3 { + font-size: 26px; + + @include media-query($on-laptop) { + font-size: 22px; + } + } + + h4 { + font-size: 20px; + + @include media-query($on-laptop) { + font-size: 18px; + } + } +} diff --git a/_sass/_syntax-highlighting.scss b/_sass/_syntax-highlighting.scss new file mode 100644 index 00000000..e36627da --- /dev/null +++ b/_sass/_syntax-highlighting.scss @@ -0,0 +1,67 @@ +/** + * Syntax highlighting styles + */ +.highlight { + background: #fff; + @extend %vertical-rhythm; + + .c { color: #998; font-style: italic } // Comment + .err { color: #a61717; background-color: #e3d2d2 } // Error + .k { font-weight: bold } // Keyword + .o { font-weight: bold } // Operator + .cm { color: #998; font-style: italic } // Comment.Multiline + .cp { color: #999; font-weight: bold } // Comment.Preproc + .c1 { color: #998; font-style: italic } // Comment.Single + .cs { color: #999; font-weight: bold; font-style: italic } // Comment.Special + .gd { color: #000; background-color: #fdd } // Generic.Deleted + .gd .x { color: #000; background-color: #faa } // Generic.Deleted.Specific + .ge { font-style: italic } // Generic.Emph + .gr { color: #a00 } // Generic.Error + .gh { color: #999 } // Generic.Heading + .gi { color: #000; background-color: #dfd } // Generic.Inserted + .gi .x { color: #000; background-color: #afa } // Generic.Inserted.Specific + .go { color: #888 } // Generic.Output + .gp { color: #555 } // Generic.Prompt + .gs { font-weight: bold } // Generic.Strong + .gu { color: #aaa } // Generic.Subheading + .gt { color: #a00 } // Generic.Traceback + .kc { font-weight: bold } // Keyword.Constant + .kd { font-weight: bold } // Keyword.Declaration + .kp { font-weight: bold } // Keyword.Pseudo + .kr { font-weight: bold } // Keyword.Reserved + .kt { color: #458; font-weight: bold } // Keyword.Type + .m { color: #099 } // Literal.Number + .s { color: #d14 } // Literal.String + .na { color: #008080 } // Name.Attribute + .nb { color: #0086B3 } // Name.Builtin + .nc { color: #458; font-weight: bold } // Name.Class + .no { color: #008080 } // Name.Constant + .ni { color: #800080 } // Name.Entity + .ne { color: #900; font-weight: bold } // Name.Exception + .nf { color: #900; font-weight: bold } // Name.Function + .nn { color: #555 } // Name.Namespace + .nt { color: #000080 } // Name.Tag + .nv { color: #008080 } // Name.Variable + .ow { font-weight: bold } // Operator.Word + .w { color: #bbb } // Text.Whitespace + .mf { color: #099 } // Literal.Number.Float + .mh { color: #099 } // Literal.Number.Hex + .mi { color: #099 } // Literal.Number.Integer + .mo { color: #099 } // Literal.Number.Oct + .sb { color: #d14 } // Literal.String.Backtick + .sc { color: #d14 } // Literal.String.Char + .sd { color: #d14 } // Literal.String.Doc + .s2 { color: #d14 } // Literal.String.Double + .se { color: #d14 } // Literal.String.Escape + .sh { color: #d14 } // Literal.String.Heredoc + .si { color: #d14 } // Literal.String.Interpol + .sx { color: #d14 } // Literal.String.Other + .sr { color: #009926 } // Literal.String.Regex + .s1 { color: #d14 } // Literal.String.Single + .ss { color: #990073 } // Literal.String.Symbol + .bp { color: #999 } // Name.Builtin.Pseudo + .vc { color: #008080 } // Name.Variable.Class + .vg { color: #008080 } // Name.Variable.Global + .vi { color: #008080 } // Name.Variable.Instance + .il { color: #099 } // Literal.Number.Integer.Long +} diff --git a/css/main.scss b/css/main.scss new file mode 100755 index 00000000..beee4e3d --- /dev/null +++ b/css/main.scss @@ -0,0 +1,52 @@ +--- +# Only the main Sass file needs front matter (the dashes are enough) +--- +@charset "utf-8"; + + + +// Our variables +$base-font-family: Helvetica, Arial, sans-serif; +$base-font-size: 16px; +$small-font-size: $base-font-size * 0.875; +$base-line-height: 1.5; + +$spacing-unit: 30px; + +$text-color: #111; +$background-color: #fdfdfd; +$brand-color: #2a7ae2; + +$grey-color: #828282; +$grey-color-light: lighten($grey-color, 40%); +$grey-color-dark: darken($grey-color, 25%); + +// Width of the content area +$content-width: 800px; + +$on-palm: 600px; +$on-laptop: 800px; + + + +// Using media queries with like this: +// @include media-query($on-palm) { +// .wrapper { +// padding-right: $spacing-unit / 2; +// padding-left: $spacing-unit / 2; +// } +// } +@mixin media-query($device) { + @media screen and (max-width: $device) { + @content; + } +} + + + +// Import partials from `sass_dir` (defaults to `_sass`) +@import + "base", + "layout", + "syntax-highlighting" +; diff --git a/favicon.ico b/favicon.ico new file mode 120000 index 00000000..99582b79 --- /dev/null +++ b/favicon.ico @@ -0,0 +1 @@ +./attachment/icons/favicon.ico \ No newline at end of file diff --git a/favicon.png b/favicon.png new file mode 120000 index 00000000..98960e0b --- /dev/null +++ b/favicon.png @@ -0,0 +1 @@ +./attachment/icons/favicon.png \ No newline at end of file diff --git a/feed.xml b/feed.xml new file mode 100644 index 00000000..b64612f4 --- /dev/null +++ b/feed.xml @@ -0,0 +1,30 @@ +--- +layout: null +--- + + + + {{ site.title | xml_escape }} + {{ site.description | xml_escape }} + {{ site.url }}{{ site.baseurl }}/ + + {{ site.time | date_to_rfc822 }} + {{ site.time | date_to_rfc822 }} + Jekyll v{{ jekyll.version }} + {% for post in site.posts %} + + {{ post.title | xml_escape }} + {{ post.content | xml_escape }} + {{ post.date | date_to_rfc822 }} + {{ post.url | prepend: site.baseurl | prepend: site.url }} + {{ post.url | prepend: site.baseurl | prepend: site.url }} + {% for tag in post.tags %} + {{ tag | xml_escape }} + {% endfor %} + {% for cat in post.categories %} + {{ cat | xml_escape }} + {% endfor %} + + {% endfor %} + + diff --git a/freenode.txt b/freenode.txt new file mode 100644 index 00000000..e69de29b diff --git a/help.md b/help.md new file mode 100644 index 00000000..915a26d3 --- /dev/null +++ b/help.md @@ -0,0 +1,40 @@ +--- +layout: page +title: Getting Help +permalink: /help/ +--- + +Need help with Qubes OS? Try these resources. + +### [Search](https://duckduckgo.com/?q=Qubes+OS) + +Add **Qubes OS** to refine your query, you might find just what you need. + +### [QubesOS Mailing Lists]({{ site.url }}{{ site.baseurl }}/wiki/QubesLists/) + +- Please send all the questions regarding Qubes OS to one of [these]({{ site.url }}{{ site.baseurl }}/wiki/QubesLists/) mailing lists. +- To subscribe to the user list, send a blank mail to `qubes-users+subscribe@googlegroups.com`. +- By sending a message to the appropriate mailing list, you are not only giving others a chance to help you, +but you may also be helping others by starting a public discussion about a shared problem or interest. +- **Please do not send questions to individual Qubes developers.** + +### [QubesOS/qubes-wiki]({{ site.url }}{{ site.baseurl }}/wiki/UserFaq/#qubes-users-faq) + +Search through the issues that the fine folks on the **Qubes Documentation** team +have answered, or ask your own at **qubes-users** mailinglist. + +### [QubesOS/qubes-issues](https://github.com/QubesOS/qubes-issues/issues) + +Search through the issues on the main Qubes OS development. Think you've +found a bug? File a new issue. + +### [QubesOS on StackOverflow](https://stackoverflow.com/questions/tagged/Qubes+OS) + +StackOverflow is a staple of any developer's diet. Check out the QubesOS tag +on StackOverflow for an answer to your question. Not there? Ask a new +question! + +### [QubesOS IRC Channel](irc:irc.freenode.net/qubes) + +Get together at **#qubes** on **irc.freenode.net**, the inofficial +QubesOS IRC channel.