The Migration from CMS to ASF-Pelican is completed! https://gora.apache.org/ is ready.
https://github.com/apache/gora-site/ For information about ASF-Pelican: https://infra.apache.org/asf-pelican.html Enjoy! Dave > On Jun 13, 2021, at 4:10 PM, Dave Fisher <w...@apache.org> wrote: > > Hi - > > The site is ready to go. https://gora.staged.apache.org > > The README on https://github.com/apache/gora-site has a pointer to the Infra > documentation and to migration notes which includes a diff on the markdown. > > I would like to make this migration live in 72 hours. > > All The Best, > Dave > >> On Jun 3, 2021, at 12:30 PM, Dave Fisher <w...@apache.org> wrote: >> >> Hi - >> >> Please find your staged migrated site at https://gora.staged.apache.org >> >> The repository is at https://github.com/apache/gora-site >> >> If you are an Gora committer then you may need to go to >> gitbox.apache.org/setup to connect your Apache ID to your GitHub ID. >> >> Any change that you commit in the repository will deploy within a few >> minutes on staged. >> >> Most of the markdown files were edited to account for differences between >> markdown.pl and the more strict GitHub Flavored Markdown (GFM) >> >> Space between ## and title. >> Title metadata required. >> Can’t mix in markdown in an html block. >> >> Note that the TOC rules differ. The Apache CMS takes every heading on the >> page while the plugin here takes every heading after the TOC. I think this a >> better experience. >> >> I’ll be updating the README.md files in few days including notes on the >> migration. >> >> All The Best, >> Dave >> >>> On May 29, 2021, at 9:34 AM, Dave Fisher <w...@apache.org> wrote: >>> >>> As you may recall the Apache CMS has been deprecated for over five years >>> now and will be decommissioned >>> by July 31, 2021. >>> >>> I’ve been tasked with moving Gora's website away from the Apache CMS. >>> I will migrate your website to a Pelican build with GitHub Flavored >>> Markdown (GFM). >>> For your reference the already migrated www-site is here >>> https://github.com/apache/www-site/ >>> >>> The following will occur. >>> - A new git repository is created. gora-site is preferred. >>> - CMS mdtext files are converted to md and stored in the content tree. >>> - Permalinks are created in the same manner. >>> - Page templates will be converted essentially as is with some minor >>> improvements. >>> - Site data feeds are analyzed. If required a data model will be created. >>> - HTML files (apidocs) built separately are copied into the content tree. >>> I’ll make a judgement call on >>> if these can be wrapped into the template. >>> >>> The Apache CMS had a cumbersome process of individual checkouts -> staging >>> -> publishing. >>> The new branching strategy is as follows: >>> - main will have the site content sources and any additional docs (like api >>> docs). >>> - asf-site will have the production website which is automatically deployed >>> to gora.apache.org. >>> During the migration we will deploy to gora.staged.apache.org >>> - preview/release will have the website prepared for the next release. You >>> will add release specific docs to this branch >>> - preview/release-staging will have the built preview website which is >>> automatically deployed to gora-release.staged.apache.org >>> >>> This new plan allows for a redesign of your site without danger of >>> premature deployment. >>> If you decide that GFM is not for gora then you can switch to a different >>> process within a preview branch. >>> >>> Release steps for the website could be: >>> - Branch main as preview/release >>> - Make your updates to preview/release >>> - Confirm your changes on gora-release.staged.apache.org >>> - Pull your changes from preview/release to main. gora.apache.org is >>> automatically updated. >>> >>> All The Best, >>> Dave Fisher >> >
