From b33926acb95e966b3f97e3f11022e40bafef18b6 Mon Sep 17 00:00:00 2001 From: Justin W. Flory Date: Oct 02 2020 16:58:19 +0000 Subject: Convert MediaWiki page to AsciiDoc file I used `pandoc` to convert most of the file, and then made some modifications by hand that `pandoc` did not carry over from the original wiki page source. Signed-off-by: Justin W. Flory --- diff --git a/council/modules/ROOT/pages/policy/community-publishing-platforms.adoc b/council/modules/ROOT/pages/policy/community-publishing-platforms.adoc new file mode 100644 index 0000000..56f9967 --- /dev/null +++ b/council/modules/ROOT/pages/policy/community-publishing-platforms.adoc @@ -0,0 +1,126 @@ += Planet + +http://planet.fedoraproject.org[Planet Fedora] is a distributed communication tool that many Fedora contributors rely on to keep a pulse on Fedora's community. +Contributors connect their http://en.wikipedia.org/wiki/Blog[blogs] to http://planet.fedoraproject.org[Planet Fedora] to express to the Fedora community their thoughts and personality as they relate to our project, and to share what they are working on in Fedora through blog posts. + + +== Appropriate Material + +The Planet is a place for expression of many ideas related to the Fedora Project. +Not every idea needs to be promotional; some ideas may be controversial or critical, or evoke other mental or emotional responses. +However, all posts to the Planet should reflect our commitment as a community to https://fedoraproject.org/wiki/Overview#Our_Community[ be excellent to each other]. +The following list contains examples of content that are not acceptable on the Planet, because they reduce the incentive for people to contribute in our community. + +=== Inappropriate material + +Material which is deemed inappropriate may be removed from the Planet without prior notice, although the Fedora Project's contributors do attempt to resolve every such situation constructively and amicably. + +Depictions of nudity, near-nudity, or other adult material:: + Our contributors represent a wide variety of backgrounds and viewpoints. + We do not want to unnecessarily restrict the audience of people who might become contributors in the future. + These types of images can have a substantial negative effect on people's perception of the Fedora community, and their desire to contribute to it. + Also, some types of material with mature subject matter may not be appropriate for all ages in our community. + Therefore they are not appropriate for the Planet, whether they are featured in and of themselves, or as backdrops for other information. + +Use of material that violates the owner's copyright:: + The Fedora Project always seeks to spread free software and content. + We do this in part by promoting creation, use, and remixing of content that reflects our values, such as Creative Commons licensed material. + We ask that all contributors respect the copyrights of content creators, and help us promote free content. + +==== Reporting a problem + +If you encounter material on the Planet that seems clearly inappropriate according to these guidelines, please notify us on freenode.net at https://webchat.freenode.net/?channels=#fedora-websites[#fedora-websites], or email mailto:webmaster@fedoraproject.org[the Fedora webmaster]. + + +== How to join the Planet + +*Read the guidelines first.* + +Before you join the Planet, you need to understand a few simple guidelines on what's appropriate to post there. +Please read https://fedoraproject.org/wiki/Planet#Appropriate_Material[these guidelines on appropriate material] before you aggregate your blog. + +. As a Fedora contributor you must have a Fedora Account System (FAS) account, have signed the contributor agreement (CLA), and be a member of at least one other group in FAS. +. Start by logging in to your fedorapeople.org account. + You must be using the SSH key https://fedoraproject.org/wiki/Infrastructure/fedorapeople.org[that you uploaded into the FAS], and your userspace is created the first time you log in: + +[source,bash] +---- +ssh accountname@fedorapeople.org +---- + +. Note: + It may take an hour for the server to sync your uploaded public key and repeated attempts to log in will cause your IP address to be banned, so be patient. +. Figure out, or set up, the category specific feed for your blog that will contain information relevant to the Fedora Planet. +. Create a file named `.planet` in the root of your home directory on fedorapeople.org. + The contents of the file follow the pattern below. + In the brackets *[ ]*, use the URL for the category specific feed from the previous step. + +[source,toml] +---- +[http://yourname.wordpress.com/category/fedora/feed/] +name = Your Name +face = http://yourname.fedorapeople.org/yourpicture.png +---- + +The first line in brackets is the *URL of your category specific RSS/RSS2/Atom feed*, not your blog's URL. +The next line is *your name* as you want it to appear on the aggregator. +The final line is optional and is the complete URL to your *hackergotchi* or personal icon. +There should be no spaces or tabs preceeding ANY of the above lines in your `.planet` file. +You can have more than one entry in your `.planet` file - just add another one in the same format. + +Note: +If you need to list multiple blogs, for some reason, you can repeat the block above using the appropriate, different values. + +=== Category, label, or tag recommended + +Please use a category, label, or tag on your personal blog to feed to the Planet, rather than your whole blog. +This allows you to mark posts that are interesting for the Fedora community. +Here are some specific instructions for making a category or label and finding your correct URL: + +* https://fedoraproject.org/wiki/How_to_provide_a_category_specific_feed_using_WordPress[How to provide a category specific feed using WordPress] +* https://fedoraproject.org/wiki/How_to_provide_a_category_specific_feed_using_Blogger[How to provide a category specific feed using Blogger] +* https://fedoraproject.org/wiki/How_to_provide_a_category_specific_feed_using_Blogspot[How to provide a category specific feed using Blogspot] +* https://fedoraproject.org/wiki/How_to_provide_a_category_specific_feed_using_Tumblr[How to provide a category specific feed using Tumblr] + +For Hugo, you would need to create a separate RSS template: https://gohugo.io/templates/rss/[[1\]]. +For Jekyll, you can create a Fedora specific RSS feed: https://cialu.net/how-to-create-fedora-feed-in-jekyll/[[2\]]. + +=== Joining a sub-planet + +There's a sub-planet picker in the top right corner of main Fedora Planet page. +Sub-planets contain posts related to a specific topic. +If you want to join a sub-planet, follow the same instructions for creating `.planet`, but instead create `.planet.` file with the same structure. +The part is derived from the URL for that sub-planet, so for example _Desktop_ sub-planet with http://fedoraplanet.org/desktop/ URL looks for `.planet.desktop` file and _Summer Coding_ sub-planet with http://fedoraplanet.org/summer-coding/ URL looks for `.planet.summer-coding` file. + +If you're not sure whether your content is appropriate for a particular sub-planet, contact one of its existing authors and ask. + +==== Sub-planet posts are not automatically forwarded to the main Fedora Planet feed + +Most people probably want their post to appear both in the sub-planet feed and the main planet feed. +That does not happen automatically, so you should have both your `.planet` and `planet.subplanet` files created to make sure your post appears in both. +You can use different categories on your blog and then use different feeds in the planet configuration files, to be able to publish just to the main planet feed (but not the sub-planet feed) if you need it. + + +== Hackergotchis + +Hackergotchi are avatars, or personal symbols representing people, used on Planet aggregators. +Often a hackergotchi is a "floating head" edited from a recent photograph, but it might be a cartoon or another symbol. +To learn more, create your own hackergotchi, or have the Design Team create one for you, have a look at the https://fedoraproject.org/wiki/Hackergotchi[Hackergotchi] page. + + +== Additional help + +Feel free to email mailto:admin@fedoraproject.org[admin at fedoraproject.org] for help. +Here is a small screencast illustrating the steps needed to create and upload your own `.planet` file: + +http://howto.nicubunu.ro/video/planet_fedora.ogg + + +== Reporting Bugs + +If you have found a bug, please send an email to the mailto:webmaster@fedoraproject.org[Websites team] including a description, screenshot (if you have one), browser name and version, and OS. + +=== Test Matrix + +We have put together a https://fedoraproject.org/wiki/Planet_Browser_Test_Matrix[test matrix] for the Planet's look and feel across browsers and platforms. +Feel free to take a look at it, or help us to expand our coverage. diff --git a/council/modules/ROOT/pages/policy/community-publishing-platforms.mediawiki b/council/modules/ROOT/pages/policy/community-publishing-platforms.mediawiki deleted file mode 100644 index 5de1ca2..0000000 --- a/council/modules/ROOT/pages/policy/community-publishing-platforms.mediawiki +++ /dev/null @@ -1,86 +0,0 @@ -{{autolang|base=yes}} - -[http://planet.fedoraproject.org Planet Fedora] is a distributed communication tool that many Fedora contributors rely on to keep a pulse on Fedora's community. Contributors connect their [http://en.wikipedia.org/wiki/Blog blogs] to -[http://planet.fedoraproject.org Planet Fedora] to express to the Fedora community their thoughts and personality as they relate to our project, and to share what they are working on in Fedora through blog posts. - -== Appropriate Material == - -The Planet is a place for expression of many ideas related to the Fedora Project. Not every idea needs to be promotional; some ideas may be controversial or critical, or evoke other mental or emotional responses. However, all posts to the Planet should reflect our commitment as a community to [[Overview#Our_Community | be excellent to each other]]. The following list contains examples of content that are not acceptable on the Planet, because they reduce the incentive for people to contribute in our community. - -=== Inappropriate material === - -Material which is deemed inappropriate may be removed from the Planet without prior notice, although the Fedora Project's contributors do attempt to resolve every such situation constructively and amicably. - -; Depictions of nudity, near-nudity, or other adult material -: Our contributors represent a wide variety of backgrounds and viewpoints. We do not want to unnecessarily restrict the audience of people who might become contributors in the future. These types of images can have a substantial negative effect on people's perception of the Fedora community, and their desire to contribute to it. Also, some types of material with mature subject matter may not be appropriate for all ages in our community. Therefore they are not appropriate for the Planet, whether they are featured in and of themselves, or as backdrops for other information. - -; Use of material that violates the owner's copyright -: The Fedora Project always seeks to spread free software and content. We do this in part by promoting creation, use, and remixing of content that reflects our values, such as Creative Commons licensed material. We ask that all contributors respect the copyrights of content creators, and help us promote free content. - -{{admon/note | Reporting a problem | If you encounter material on the Planet that seems clearly inappropriate according to these guidelines, please notify us on freenode.net at {{fpchat|#fedora-websites}}, or email [mailto:webmaster@fedoraproject.org the Fedora webmaster].}} - -== How to join the Planet == -{{admon/important|Read the guidelines first.|Before you join the Planet, you need to understand a few simple guidelines on what's appropriate to post there. Please read [[Planet#Appropriate_Material|these guidelines on appropriate material]] before you aggregate your blog.}} - -
  1. As a Fedora contributor you must have a Fedora Account System (FAS) account, have signed the contributor agreement (CLA), and be a member of at least one other group in FAS.
    2. - -
  2. Start by logging in to your fedorapeople.org account. You must be using the SSH key [[Infrastructure/fedorapeople.org|that you uploaded into the FAS]], and your userspace is created the first time you log in: -
    ssh accountname@fedorapeople.org
    3. -
  3. Note: It may take an hour for the server to sync your uploaded public key and repeated attempts to log in will cause your IP address to be banned, so be patient.
    4. - -
  4. Figure out, or set up, the category specific feed for your blog that will contain information relevant to the Fedora Planet. -{{admon/note|Category, label, or tag recommended|Please use a category, label, or tag on your personal blog to feed to the Planet, rather than your whole blog. This allows you to mark posts that are interesting for the Fedora community. Here are some specific instructions for making a category or label and finding your correct URL: - -: [[How to provide a category specific feed using WordPress]] -: [[How to provide a category specific feed using Blogger]] -: [[How to provide a category specific feed using Blogspot]] -: [[How to provide a category specific feed using Tumblr]] - -For Hugo, you would need to create a separate RSS template: [https://gohugo.io/templates/rss/]. -For Jekyll, you can create a Fedora specific RSS feed: [https://cialu.net/how-to-create-fedora-feed-in-jekyll/]. - -}}
    5. - - -
  5. Create a file named .planet in the root of your home directory on fedorapeople.org. The contents of the file follow the pattern below. In the brackets '''[ ]''', use the URL for the category specific feed from the previous step. -
    -[http://yourname.wordpress.com/category/fedora/feed/]
-name = Your Name
-face = http://yourname.fedorapeople.org/yourpicture.png
-
    -The first line in brackets is the '''URL of your category specific RSS/RSS2/Atom feed''', not your blog's URL. - -The next line is '''your name''' as you want it to appear on the aggregator. - -The final line is optional and is the complete URL to your '''hackergotchi''' or personal icon. There should be no spaces or tabs preceeding ANY of the above lines in your .planet file. You can have more than one entry in your .planet file - just add another one in the same format. - -Note: If you need to list multiple blogs, for some reason, you can repeat the block above using the appropriate, different values.
- -=== Joining a sub-planet === - -There's a sub-planet picker in the top right corner of main Fedora Planet page. Sub-planets contain posts related to a specific topic. If you want to join a sub-planet, follow the same instructions for creating .planet, but instead create .planet. file with the same structure. The part is derived from the URL for that sub-planet, so for example ''Desktop'' sub-planet with http://fedoraplanet.org/desktop/ URL looks for .planet.desktop file and ''Summer Coding'' sub-planet with http://fedoraplanet.org/summer-coding/ URL looks for .planet.summer-coding file. - -{{admon/note|Sub-planet posts are not automatically forwarded to the main Fedora Planet feed|Most people probably want their post to appear both in the sub-planet feed and the main planet feed. That does not happen automatically, so you should have both your .planet and planet.subplanet files created to make sure your post appears in both. You can use different categories on your blog and then use different feeds in the planet configuration files, to be able to publish just to the main planet feed (but not the sub-planet feed) if you need it.}} - -If you're not sure whether your content is appropriate for a particular sub-planet, contact one of its existing authors and ask. - -== Hackergotchis == - -Hackergotchi are avatars, or personal symbols representing people, used on Planet aggregators. Often a hackergotchi is a "floating head" edited from a recent photograph, but it might be a cartoon or another symbol. To learn more, create your own hackergotchi, or have the Design Team create one for you, have a look at the [[Hackergotchi]] page. - -== Additional help == -Feel free to email [mailto:admin@fedoraproject.org admin at fedoraproject.org] for help. - -Here is a small screencast illustrating the steps needed to create and upload your own .planet file: http://howto.nicubunu.ro/video/planet_fedora.ogg - -== Reporting Bugs == - -If you have found a bug, please send an email to the [mailto:webmaster@fedoraproject.org Websites team] including a description, screenshot (if you have one), browser name and version, and OS. - -=== Test Matrix === - -We have put together a [[Planet_Browser_Test_Matrix|test matrix]] for the Planet's look and feel across browsers and platforms. Feel free to take a look at it, or help us to expand our coverage. - - -[[Category:Documentation]] -[[Category:How to]]