Openmage

[splendidinternet]

This PR is a:

• New topic
• Content update
• Content fix or rewrite
• Bug fix or improvement

Summary

We have renamed the Magento devdocs to OpenMage devdocs and changed colors and logos. We changed the styling, fonts, colors and some layout files, such that it closer resembles the style of the openmage website, and less the style of the old magento sites.

The content was updated with the content of this repository: https://github.com/OpenMage/devdocs-m1

[colinmollenhour]

Thanks for the PR! Unfortunately the page still doesn't build. Can you look into this? The error is:

The page build failed for the master branch with the following error:
 
The tag glossarytooltip on line 27 in mftf/2.2/getting-started.md is not a recognized Liquid tag. For more information, see https://docs.github.com/github/working-with-github-pages/troubleshooting-jekyll-build-errors-for-github-pages-sites#unknown-tag-error.
 
For information on troubleshooting Jekyll see:
 
https://docs.github.com/articles/troubleshooting-jekyll-builds
 
If you have any questions you can submit a request on the Contact GitHub page at https://support.github.com/contact?repo_id=265988482&page_build_id=198517276

[colinmollenhour]

I've just added you as a maintainer so you can push directly to master as needed, hopefully that will make it easier.

[splendidinternet]

Hi Collin,

Do you build the documentation with "github pages"? If so, I'm afraid we can't do much
about it:

The documentation of github-pages states:

Unsupported plugins are a common source of unrecognized tags

On ·this page Github links to a list of supported plugins:

Unfortunately glossarytooltip is not a part of it.

What you / we can do is this, as stated in the documentation:

GitHub Pages cannot build sites using unsupported plugins. If you want to use unsupported plugins, generate your site locally and then push your site's static files to GitHub.

Does that make sense to you?

Regards

[splendidinternet]

If you absolutely want or need to use github pages, we could also replace the tags with corresp. html-code.

[colinmollenhour]

Ahh ok, that makes sense. I'm fine either way:

1. Make the site compatible with GitHub Pages and get free and easy hosting
2. Use another host, and perhaps another build tool (although I think Github Actions could still be used to do a custom build)

I'll defer to you.

[splendidinternet]

We already have an instance of the openmage devdocs running.

We are still waiting for information from openmage to set up the DNS entries for us. In the meantime, we have registered www.devdocs-openmage.org for our instance. We are also willing to put s.th. into place with github actions.

So we are going for option #2. But we'd keep Jekyll in place for the time being. On our host it works fine.

[colinmollenhour]

Sounds good @splendidinternet, we'll hopefully get the DNS added soon, thanks for getting this working!