This is an automated email from the ASF dual-hosted git repository. dahn pushed a commit to branch old-style-blogs in repository https://gitbox.apache.org/repos/asf/cloudstack-www.git
commit d932f85d7301805fd20c41a3481060039576c6e3 Author: Daan Hoogland <[email protected]> AuthorDate: Thu Jan 4 10:44:33 2024 +0100 blog in old site procedure --- README.md | 19 ++++++ docusaurus.config.js | 133 ++-------------------------------------- docusaurus.config.js.blog | 150 ---------------------------------------------- 3 files changed, 23 insertions(+), 279 deletions(-) diff --git a/README.md b/README.md index ee5c7ab1..03241fc0 100644 --- a/README.md +++ b/README.md @@ -43,3 +43,22 @@ This command generates static content into the `build` directory and can be served using any static contents hosting service. We've Github Actions based automation that can publish changes merged to 'main' branch being automatically published to the 'asf-site'. + +### temporary blog only publishing mech + +This procedure is obsolete as soon as the site is migrated to docusaurus completely + +1. Build the docusaruas branch locally: +``` + # checkout the right branch: + git checkout old-style-blogs + yarn clear + yarn install + yarn build +``` +2. Then move the `build` directory to some other place, like `mv build ..` +3. `git checkout -- .` and then checkout `git checkout asf-site` branch +4. `cd content/` to manually copy artifacts from `../build/` path. +5. Generally I copy the `assets`, `blog`, `img` and `files` directory in the content directory from `../../build/` +6. git add <files> and commit/push to asf-site branch +7. git cherry-pick <commitish> for the new blogs to make sure they don't get lost when we migrate completely diff --git a/docusaurus.config.js b/docusaurus.config.js index 7056454c..4a3183ff 100644 --- a/docusaurus.config.js +++ b/docusaurus.config.js @@ -53,140 +53,15 @@ const config = { logo: { alt: 'apache-cloudstack', src: 'img/navlogo.png', + href: 'https://cloudstack.apache.org/' }, items: [ { - label: 'About', - position: 'right', - items: [ - { - label: 'About', - href: '/about' - }, - { - label: 'History', - href: '/history' - }, - { - label: 'Features', - href: '/features' - }, - { - label: 'Who We Are', - href: '/who' - }, - { - label: 'Community Bylaws', - href: '/bylaws' - }, - { - label: 'Trademark Guidelines', - href: '/trademark-guidelines' - }, - { - label: 'Security', - href: '/security' - } - ] - }, - //{type: 'doc', docId: 'getting-started', position: 'right', label: 'Docs'}, - //{type: 'doc', docId: 'community', position: 'right', label: 'Community', docsPluginId: 'community'}, - { - label: 'Community', - position: 'right', - items: [ - { - label: 'Get Involved', - href: '/contribute' - }, - { - label: 'Developer Resources', - href: '/developers' - }, - { - label: 'Join Mailing Lists', - href: '/mailing-lists' - }, - { - label: 'Issues Tracker', - href: 'https://github.com/apache/cloudstack/issues' - }, - { - label: 'Community Slack', - href: 'https://join.slack.com/t/apachecloudstack/shared_invite/zt-1u8qwbivp-u16HRI~LWioLmF1G2D3Iyg', - }, - { - label: 'Events and Meetups', - href: '/events' - }, - { - label: 'Collab Conference', - href: 'https://www.cloudstackcollab.org/' - }, - ] - }, - { - label: 'Use Cases', - position: 'right', - items: [ - { - label: 'Cloud Builders', - href: '/cloud-builders' - }, - { - label: 'Kubernetes', - href: '/kubernetes' - } - ] - }, - { - label: 'Users', - position: 'right', - items: [ - { - label: 'Known Users', - href: '/users' - }, - { - label: 'Case Studies', - href: 'https://cwiki.apache.org/confluence/display/CLOUDSTACK/Case+Studies' - }, - { - label: 'Take Survey', - href: '/survey' - } - ] - }, - { - label: 'Documentation', - position: 'right', - items: [ - { - label: 'CloudStack Documentation', - href: 'https://docs.cloudstack.apache.org' - }, - { - label: 'Project Wiki', - href: 'https://cwiki.apache.org/confluence/display/CLOUDSTACK/Home' - }, - { - label: 'CloudStack Books', - href: 'https://cwiki.apache.org/confluence/display/CLOUDSTACK/CloudStack+Books' - }, - { - label: 'API Documentation', - href: '/api/' - } - ] - }, - { - label: 'Download', - position: 'right', - href: '/downloads' + label: 'Home', + href: 'https://cloudstack.apache.org/' }, { label: 'Blog', - position: 'right', href: '/blog' }, { @@ -245,7 +120,7 @@ const config = { <span> Copyright © ${new Date().getFullYear()} The Apache Software Foundation, Licensed under the Apache License, Version 2.0. "Apache", "CloudStack", "Apache CloudStack", the Apache CloudStack logo, the Apache CloudStack Cloud Monkey logo and the Apache feather logos are registered trademarks or trademarks of The Apache Software Foundation. - <br/><a href="/trademark-guidelines">Apache CloudStack Trademark Usage</a> - <a href="/bylaws">Apache CloudStack Community ByLaws</a> - <a href="https://github.com/apache/cloudstack-www";>Website Source Code</a> + <br/><a href="/trademark-guidelines.html">Apache CloudStack Trademark Usage</a> - <a href="/bylaws.html">Apache CloudStack Community ByLaws</a> - <a href="https://github.com/apache/cloudstack-www";>Website Source Code</a> </span></div></div>`, }, prism: { diff --git a/docusaurus.config.js.blog b/docusaurus.config.js.blog deleted file mode 100644 index 4a3183ff..00000000 --- a/docusaurus.config.js.blog +++ /dev/null @@ -1,150 +0,0 @@ -// @ts-check -// Note: type annotations allow type checking and IDEs autocompletion - -const lightCodeTheme = require('prism-react-renderer/themes/github'); -const darkCodeTheme = require('prism-react-renderer/themes/dracula'); - -/** @type {import('@docusaurus/types').Config} */ -const config = { - title: 'Apache CloudStack', - tagline: 'Open Source Cloud Computing™', - url: 'https://cloudstack.apache.org', - baseUrl: '/', - onBrokenLinks: 'log', - onBrokenMarkdownLinks: 'throw', - favicon: 'img/favicon.ico', - - plugins: [ - ['docusaurus-plugin-sass', {}], - ], - - presets: [ - [ - 'classic', - /** @type {import('@docusaurus/preset-classic').Options} */ - ({ - docs: { - path: 'docs', - routeBasePath: "/website-guide", - showLastUpdateAuthor: false, - showLastUpdateTime: false, - editUrl: 'https://github.com/apache/cloudstack-www/tree/main/', - }, - blog: { - blogTitle: 'Blog', - blogDescription: 'Apache CloudStack Blog', - showReadingTime: false, - blogSidebarTitle: 'Recent Posts', - blogSidebarCount: 10, - editUrl: 'https://github.com/apache/cloudstack-www/tree/main/', - }, - theme: { - customCss: require.resolve('./src/css/custom.css'), - }, - }), - ], - ], - - themeConfig: - /** @type {import('@docusaurus/preset-classic').ThemeConfig} */ - ({ - navbar: { - title: '', - logo: { - alt: 'apache-cloudstack', - src: 'img/navlogo.png', - href: 'https://cloudstack.apache.org/' - }, - items: [ - { - label: 'Home', - href: 'https://cloudstack.apache.org/' - }, - { - label: 'Blog', - href: '/blog' - }, - { - href: 'https://github.com/apache/cloudstack', - position: 'right', - className: 'header-github-link', - 'aria-label': 'GitHub repository', - }, - {type: 'search', position: 'right'}, - { - type: 'dropdown', - label: 'ASF', - position: 'right', - items: [ - {label: 'Foundation', to: 'https://www.apache.org/'}, - {label: 'License', to: 'https://www.apache.org/licenses/'}, - {label: 'Events', to: 'https://www.apache.org/events/current-event'}, - {label: 'Security', to: 'https://www.apache.org/security/'}, - {label: 'Sponsorship', to: 'https://www.apache.org/foundation/sponsorship.html'}, - {label: 'Privacy', to: 'https://www.apache.org/foundation/policies/privacy.html'}, - {label: 'Thanks', to: 'https://www.apache.org/foundation/thanks.html'} - ], - }, - ], - }, - footer: { - style: 'light', - logo: { - alt: 'Apache CloudStack logo', - src: 'img/banner.svg', - href: 'https://cloudstack.apache.org/' - }, - copyright: ` - <div style="opacity: 0.5"> - <a href="mailto:[email protected]"; target="_blank"> - <img src="/img/social/mail.svg" title="Join Dev Mailing List" height="32px" /> - </a> - <a href="https://join.slack.com/t/apachecloudstack/shared_invite/zt-1u8qwbivp-u16HRI~LWioLmF1G2D3Iyg"; target="_blank"> - <img src="/img/social/slack.svg" title="Join Slack" height="32px" /> - </a> - <a href="https://github.com/apache/cloudstack"; target="_blank"> - <img src="/img/social/github.svg" title="Github" height="32px" /> - </a> - <a href="https://twitter.com/CloudStack"; target="_blank"> - <img src="/img/social/twitter.svg" title="Twitter" height="32px" /> - </a> - <a href="https://www.youtube.com/@ApacheCloudStack"; target="_blank"> - <img src="/img/social/youtube.svg" title="YouTube" height="32px" /> - </a> - <a href="https://www.linkedin.com/company/apachecloudstack/posts/"; target="_blank"> - <img src="/img/social/linkedin.svg" title="LinkedIn" height="32px" /> - </a> - </div> - <div style="text-align: left;"> - <div style="border-top: 1px solid #ccc;min-height: 60px;line-height: 20px;text-align: center;font-family: Avenir-Medium,serif;font-size: 14px;color: #999;display: flex;align-items: center;"> - <span> - Copyright © ${new Date().getFullYear()} The Apache Software Foundation, Licensed under the Apache License, Version 2.0. - "Apache", "CloudStack", "Apache CloudStack", the Apache CloudStack logo, the Apache CloudStack Cloud Monkey logo and the Apache feather logos are registered trademarks or trademarks of The Apache Software Foundation. - <br/><a href="/trademark-guidelines.html">Apache CloudStack Trademark Usage</a> - <a href="/bylaws.html">Apache CloudStack Community ByLaws</a> - <a href="https://github.com/apache/cloudstack-www";>Website Source Code</a> - </span></div></div>`, - }, - prism: { - theme: lightCodeTheme, - darkTheme: darkCodeTheme, - additionalLanguages: ['properties'], - }, - colorMode: { - defaultMode: 'light', - disableSwitch: true, - }, - }), - - themes: [ - [ - require.resolve("@easyops-cn/docusaurus-search-local"), - { - hashed: true, - indexDocs: false, - indexPages: true, - language: ["en"], - } - ], - ] -}; - -module.exports = config;
