From 31f91b65adc0ee792f893268e1ba665f361e0622 Mon Sep 17 00:00:00 2001 From: Justin W. Flory Date: Sep 09 2018 00:05:20 +0000 Subject: [PATCH 1/2] Add Antora template by @asamalik for D&I Team --- diff --git a/antora.yml b/antora.yml new file mode 100644 index 0000000..062c01c --- /dev/null +++ b/antora.yml @@ -0,0 +1,16 @@ +# Name will be mostly visible in the URL. Treat it as an indentifier. +# Tip: If you want to use the local preview scripts that come with this repository, please change this value in the site.yml file as well. (under site/start_page) +name: diversity-inclusion + +# Title will be visible on the page. +title: Fedora Diversity and Inclusion Team + +# If you don't plan to have multiple versions of the docs (for example, to document multiple versions of some software), you can ignore this field. Otherwise, change "master" to a specific version. +version: master + +# We encourage you to name the index page as "index.adoc". If you absolutely have to use a different name, please reflect it here. You can ignore this field otherwise. +start_page: ROOT:index + +# This lists all the menu definitions of your component. +nav: +- modules/ROOT/nav.adoc diff --git a/build.sh b/build.sh new file mode 100755 index 0000000..c9349e3 --- /dev/null +++ b/build.sh @@ -0,0 +1,16 @@ +#!/bin/sh + +if [ "$(uname)" == "Darwin" ]; then + # Running on macOS. + # Let's assume that the user has the Docker CE installed + # which doesn't require a root password. + docker run --rm -it -v $(pwd):/antora antora/antora --html-url-extension-style=indexify site.yml + +elif [ "$(expr substr $(uname -s) 1 5)" == "Linux" ]; then + # Running on Linux. + # Let's assume that it's running the Docker deamon + # which requires root. + echo "" + echo "This build script is using Docker to run the build in an isolated environment. You might be asked for a root password in order to start it." +sudo docker run --rm -it -v $(pwd):/antora:z antora/antora --html-url-extension-style=indexify site.yml +fi diff --git a/modules/ROOT/nav.adoc b/modules/ROOT/nav.adoc new file mode 100644 index 0000000..35731c3 --- /dev/null +++ b/modules/ROOT/nav.adoc @@ -0,0 +1,2 @@ +* xref:index.adoc[Diversity and Inclusion] +* xref:team.adoc[Fedora D&I Team] diff --git a/preview.sh b/preview.sh new file mode 100755 index 0000000..acab783 --- /dev/null +++ b/preview.sh @@ -0,0 +1,18 @@ +#!/bin/sh + +if [ "$(uname)" == "Darwin" ]; then + # Running on macOS. + # Let's assume that the user has the Docker CE installed + # which doesn't require a root password. + echo "The preview will be available at http://localhost:8080/" + docker run --rm -v $(pwd)/public:/usr/share/nginx/html:ro -p 8080:80 nginx + +elif [ "$(expr substr $(uname -s) 1 5)" == "Linux" ]; then + # Running on Linux. + # Let's assume that it's running the Docker deamon + # which requires root. + echo "" + echo "This build script is using Docker to run the build in an isolated environment. You might be asked for a root password in order to start it." + echo "The preview will be available at http://localhost:8080/" + sudo docker run --rm -v $(pwd)/public:/usr/share/nginx/html:ro -p 8080:80 nginx +fi diff --git a/site.yml b/site.yml new file mode 100644 index 0000000..5f60d10 --- /dev/null +++ b/site.yml @@ -0,0 +1,20 @@ +site: + title: Local Preview + start_page: diversity-inclusion::index +content: + sources: + - url: . + branches: HEAD +ui: + bundle: + url: https://asamalik.fedorapeople.org/ui-bundle.zip + snapshot: true + default_layout: with_menu +output: + clean: true + dir: ./public + destinations: + - provider: archive +runtime: + pull: true + cache_dir: ./cache From a184eb3b22b57250221d802f75ca79876e19edad Mon Sep 17 00:00:00 2001 From: Justin W. Flory Date: Sep 11 2018 00:06:51 +0000 Subject: [PATCH 2/2] Initial content from Fedora Wiki (converted with pandoc) --- diff --git a/modules/ROOT/nav.adoc b/modules/ROOT/nav.adoc index 35731c3..bf24115 100644 --- a/modules/ROOT/nav.adoc +++ b/modules/ROOT/nav.adoc @@ -1,2 +1 @@ -* xref:index.adoc[Diversity and Inclusion] * xref:team.adoc[Fedora D&I Team] diff --git a/modules/ROOT/pages/index.adoc b/modules/ROOT/pages/index.adoc new file mode 100644 index 0000000..aaa6948 --- /dev/null +++ b/modules/ROOT/pages/index.adoc @@ -0,0 +1,61 @@ += Fedora Diversity and Inclusion Team + +The Fedora Project welcomes and encourages participation by everyone. +Our community is based on mutual respect, tolerance, and encouragement, and we are working to help each other live up to these principles. +Please, refer to our https://getfedora.org/code-of-conduct[Code of Conduct] if you need more information. +Fedora Diversity and Inclusion team is committed to fostering diversity and inclusion in Fedora community. +You can watch our recent video showcasing the Fedora community https://youtu.be/Ig0gnM9jsm0[here]. + + +[[goals]] +== Goals + +The goal of this initiative is to help foster diversity and inclusion in Fedora community. +Fedora Diversity and Inclusion team works towards this goal by focusing on efforts including (but not limited to) + +* Creating content and organizing events to spread awareness about diversity in Fedora within and outside the Fedora community. +* Supporting community building and engagement activities to foster inclusion. +* Coordinating with Fedora SIGs and subprojects to foster Diversity and Inclusion in the community. +* Supporting programs committed to building diversity and inclusion in Free and Open Source Software communities. + + +[[join]] +== Join + +If you'd like to help out, please send an introduction to the mailing list and introduce yourself in IRC. +You can also join the conversation on Telegram bridge to IRC https://t.me/fedoradiversity[here.] + + +[[meetings]] +== Meetings + +The Diversity and Inclusion team meets *bi-weekly* in #fedora-diversity at 12:30 UTC on Fridays. +The calendar for future meetings is available https://apps.fedoraproject.org/calendar/meeting/6397/[here]. +Meeting logs are available at https://meetbot.fedoraproject.org/sresults/?group_id=fedora-diversity&type=channel[Meetbot] + + +[[current-projects]] +== Current Projects + +We are tracking our ongoing work and action items https://pagure.io/fedora-diversity/issues[here] in Pagure. + + +[[fedora-women]] +=== Fedora Women + +Fedora Women aims to foster involvement of women (cis and trans) and genderqueer people in Fedora and Free and Open Source Software. + + +[[events]] +=== Events + +Fedora Diversity and Inclusion team organizes and supports a variety of events with an aim of fostering diversity and inclusion in Fedora community. +https://fedoraproject.org/wiki/Diversity_Events[Here] is the list of events. +Please send us an email if you are interested in helping us organize events in your local community related to promoting diversity and inclusion in open source communities including Fedora. + + +[[contacts]] +== Community Contacts + +Diversity efforts require that we work with all parts of Fedora. +To get in touch with Fedora Diversity and Inclusion team, please send an email to our mailing list or connect with us on IRC or via Telegram. diff --git a/modules/ROOT/pages/team.adoc b/modules/ROOT/pages/team.adoc new file mode 100644 index 0000000..0098531 --- /dev/null +++ b/modules/ROOT/pages/team.adoc @@ -0,0 +1,52 @@ += Fedora Diversity and Inclusion Team + +Fedora Diversity and Inclusion team is committed to fostering diversity and inclusion in Fedora community. +You can watch our recent video showcasing the Fedora community https://youtu.be/Ig0gnM9jsm0[here]. + + +[[goals]] +== Goals + +The goal of this initiative is to help foster diversity and inclusion in Fedora community. +Fedora Diversity and Inclusion team works towards this goal by focusing on efforts including (but not limited to): + +* Creating content and organizing events to spread awareness about diversity in Fedora within and outside the Fedora community. +* Supporting community building and engagement activities to foster inclusion. +* Coordinating with Fedora SIGs and subprojects to foster Diversity and Inclusion in the community. +* Supporting programs committed to building diversity and inclusion in Free and Open Source Software communities. + + +[[current-projects]] +== Current Projects + +We are tracking our ongoing work and action items https://pagure.io/fedora-diversity/issues[here] in Pagure. + + +[[meetings]] +== Meetings + +The Diversity and Inclusion team meets *bi-weekly* in #fedora-diversity at 1300 UTC on Fridays. +The calendar for future meetings is available https://apps.fedoraproject.org/calendar/meeting/6397/[here]. +Meeting logs are available at https://meetbot.fedoraproject.org/sresults/?group_id=fedora-diversity&type=channel[Meetbot] + + +[[get-in-touch]] +== Get in touch with us + +* Want to help us shape diversity and inclusion in Fedora community? + We feel that everyone can bring in valuable inputs to this conversation. + We have diverse and flexible contribution opportunities available for everyone. + You can join the conversation via IRC #fedora-diversity on Freenode. + We also have a Telegram bridge to IRC https://t.me/fedoradiversity[here.]. + Feel free to introduce yourself on our [diversity@lists.fedoraproject.org mailing list]. + +* Feel like you don't have much time to contribute? + Subscribe to our [diversity@lists.fedoraproject.org mailing list] to receive updates about our work. + +* Are you a part of a local hackerspace, LUG or STEM community? + Are you involved in open source project beyond Fedora? + Did you say YES to any one of these? + +We are especially looking for other open source projects and local communities to share resources and collaborate together. +If you are interested in collaborating with us, please get in touch with us via IRC #fedora-diversity on Freenode or [diversity@lists.fedoraproject.org mailing list]. +We also have a Telegram bridge to IRC https://t.me/fedoradiversity[here.].