diff --git a/website/blog/2023-08-17-bison-v3-8-2-1-released.mdx b/website/blog/2023-08-17-bison-v3-8-2-1-released.mdx index 7a90c17..a1ed396 100644 --- a/website/blog/2023-08-17-bison-v3-8-2-1-released.mdx +++ b/website/blog/2023-08-17-bison-v3-8-2-1-released.mdx @@ -26,6 +26,7 @@ Version **3.8.2-1** is the first release of GNU bison. import Image from '@theme/IdealImage'; +import CodeBlock from '@theme/CodeBlock'; The [xPack GNU bison](https://xpack.github.io/bison/) is a standalone cross-platform binary distribution of @@ -60,8 +61,14 @@ The binary files are available from GitHub Re ## Install -The full details of installing the **xPack GNU bison** on various platforms -are presented in the [Install Guide](/docs/install/). +The easiest way to install this specific version, is by using **xpm**: + + { +`xpm install @xpack-dev-tools/bison@${frontMatter.version}.${frontMatter.npm_subversion} -verbose +`} + +Comprehensive instructions for installing **xPack GNU bison** on different platforms +can be found in the [Install Guide](/docs/install/). ## Compliance @@ -143,11 +150,11 @@ xpack-bison-3.8.2-1-linux-x64.tar.gz ### 32-bit support -Support for 32-bit Intel Linux and Intel Windows was -dropped in 2022. Support for 32-bit Arm Linux (armv7l) will be preserved +Support for 32-bit x86 GNU/Linux and x86 Windows was +dropped in 2022. Support for 32-bit Arm GNU/Linux (armv7l) will be preserved for a while, due to the large user base of 32-bit Raspberry Pi systems. -### Linux minimum requirements +### GNU/Linux minimum requirements Support for RedHat 7 was dropped in 2022 and the minimum requirement was raised to GLIBC 2.27, available starting diff --git a/website/blog/_common/_deprecation-notices-glib-2.27.mdx b/website/blog/_common/_deprecation-notices-glib-2.27.mdx index b50b28e..e1727b3 100644 --- a/website/blog/_common/_deprecation-notices-glib-2.27.mdx +++ b/website/blog/_common/_deprecation-notices-glib-2.27.mdx @@ -6,7 +6,7 @@ ## Deprecation notices -### Linux minimum requirements +### GNU/Linux minimum requirements The minimum requirement is **GLIBC 2.27**, available starting with Ubuntu 18, Debian 10 and RedHat 8. @@ -14,13 +14,13 @@ Support for RedHat 7 was dropped in 2022. ### 32-bit support -Support for 32-bit Intel Linux and Intel Windows was +Support for 32-bit x86 GNU/Linux and x86 Windows was dropped in 2022. -### Pre-deprecation notice for 32-bit Arm Linux +### Pre-deprecation notice for 32-bit Arm GNU/Linux Due to the large user base of 32-bit Raspberry Pi systems, -support for 32-bit Arm Linux (armv7l) will be preserved +support for 32-bit Arm GNU/Linux (armv7l) will be preserved for a little while, but expect it to be dropped by 2025, so it is recommended to consider an upgrade to a RPi 4 or 5 with at least 4 GB (preferably 8 GB) of RAM. diff --git a/website/docs/about/_common/History32bitDiscontinued/index.tsx b/website/docs/about/_common/History32bitDiscontinued/index.tsx new file mode 100644 index 0000000..550c39e --- /dev/null +++ b/website/docs/about/_common/History32bitDiscontinued/index.tsx @@ -0,0 +1,19 @@ +/* + * DO NOT EDIT! + * Automatically generated from xbb-helper/templates/docusaurus/common. + * + * This file is part of the xPack project (http://xpack.github.io). + * Copyright (c) 2024 Liviu Ionescu. All rights reserved. + * + * Permission to use, copy, modify, and/or distribute this software + * for any purpose is hereby granted, under the terms of the MIT license. + * + * If a copy of the license was not distributed with this file, it can + * be obtained from https://opensource.org/licenses/MIT/. + */ + +export default function History32bitDiscontinued({platforms}): JSX.Element { + return ( + <>Support for {platforms} (32-bit) was discontinued + ); +} diff --git a/website/docs/about/_common/HistoryAppleSiliconAdded/index.tsx b/website/docs/about/_common/HistoryAppleSiliconAdded/index.tsx new file mode 100644 index 0000000..42a027d --- /dev/null +++ b/website/docs/about/_common/HistoryAppleSiliconAdded/index.tsx @@ -0,0 +1,19 @@ +/* + * DO NOT EDIT! + * Automatically generated from xbb-helper/templates/docusaurus/common. + * + * This file is part of the xPack project (http://xpack.github.io). + * Copyright (c) 2024 Liviu Ionescu. All rights reserved. + * + * Permission to use, copy, modify, and/or distribute this software + * for any purpose is hereby granted, under the terms of the MIT license. + * + * If a copy of the license was not distributed with this file, it can + * be obtained from https://opensource.org/licenses/MIT/. + */ + +export default function HistoryAppleSiliconAdded(): JSX.Element { + return ( + <>Support for Apple Silicon macOS was added + ); +} diff --git a/website/docs/about/_common/HistoryArmLinuxAdded/index.tsx b/website/docs/about/_common/HistoryArmLinuxAdded/index.tsx new file mode 100644 index 0000000..7702422 --- /dev/null +++ b/website/docs/about/_common/HistoryArmLinuxAdded/index.tsx @@ -0,0 +1,19 @@ +/* + * DO NOT EDIT! + * Automatically generated from xbb-helper/templates/docusaurus/common. + * + * This file is part of the xPack project (http://xpack.github.io). + * Copyright (c) 2024 Liviu Ionescu. All rights reserved. + * + * Permission to use, copy, modify, and/or distribute this software + * for any purpose is hereby granted, under the terms of the MIT license. + * + * If a copy of the license was not distributed with this file, it can + * be obtained from https://opensource.org/licenses/MIT/. + */ + +export default function HistoryArmLinuxAdded(): JSX.Element { + return ( + <>Support for 32/64-bit Arm GNU/Linux platforms (like Raspberry Pi) was added + ); +} diff --git a/website/docs/about/_common/HistoryPlatformsAdded/index.tsx b/website/docs/about/_common/HistoryPlatformsAdded/index.tsx new file mode 100644 index 0000000..80fd948 --- /dev/null +++ b/website/docs/about/_common/HistoryPlatformsAdded/index.tsx @@ -0,0 +1,19 @@ +/* + * DO NOT EDIT! + * Automatically generated from xbb-helper/templates/docusaurus/common. + * + * This file is part of the xPack project (http://xpack.github.io). + * Copyright (c) 2024 Liviu Ionescu. All rights reserved. + * + * Permission to use, copy, modify, and/or distribute this software + * for any purpose is hereby granted, under the terms of the MIT license. + * + * If a copy of the license was not distributed with this file, it can + * be obtained from https://opensource.org/licenses/MIT/. + */ + +export default function HistoryPlatformsAdded({platforms}): JSX.Element { + return ( + <>Support for {platforms} was added + ); +} diff --git a/website/docs/about/_common/HistoryRenameXpack/index.tsx b/website/docs/about/_common/HistoryRenameXpack/index.tsx new file mode 100644 index 0000000..c82bc1b --- /dev/null +++ b/website/docs/about/_common/HistoryRenameXpack/index.tsx @@ -0,0 +1,19 @@ +/* + * DO NOT EDIT! + * Automatically generated from xbb-helper/templates/docusaurus/common. + * + * This file is part of the xPack project (http://xpack.github.io). + * Copyright (c) 2024 Liviu Ionescu. All rights reserved. + * + * Permission to use, copy, modify, and/or distribute this software + * for any purpose is hereby granted, under the terms of the MIT license. + * + * If a copy of the license was not distributed with this file, it can + * be obtained from https://opensource.org/licenses/MIT/. + */ + +export default function HistoryRenameXpack(): JSX.Element { + return ( + <>The project was renamed xPack GNU bison + ); +} diff --git a/website/docs/about/_common/HistoryWindowsUcrt/index.tsx b/website/docs/about/_common/HistoryWindowsUcrt/index.tsx new file mode 100644 index 0000000..af51abc --- /dev/null +++ b/website/docs/about/_common/HistoryWindowsUcrt/index.tsx @@ -0,0 +1,19 @@ +/* + * DO NOT EDIT! + * Automatically generated from xbb-helper/templates/docusaurus/common. + * + * This file is part of the xPack project (http://xpack.github.io). + * Copyright (c) 2024 Liviu Ionescu. All rights reserved. + * + * Permission to use, copy, modify, and/or distribute this software + * for any purpose is hereby granted, under the terms of the MIT license. + * + * If a copy of the license was not distributed with this file, it can + * be obtained from https://opensource.org/licenses/MIT/. + */ + +export default function HistoryWindowsUcrt(): JSX.Element { + return ( + <>In the Windows binaries, the MSVC runtime was replaced with the newer Universal C Runtime (UCRT) + ); +} diff --git a/website/docs/about/_common/HistoryXpm/index.tsx b/website/docs/about/_common/HistoryXpm/index.tsx new file mode 100644 index 0000000..2415632 --- /dev/null +++ b/website/docs/about/_common/HistoryXpm/index.tsx @@ -0,0 +1,21 @@ +/* + * DO NOT EDIT! + * Automatically generated from xbb-helper/templates/docusaurus/common. + * + * This file is part of the xPack project (http://xpack.github.io). + * Copyright (c) 2024 Liviu Ionescu. All rights reserved. + * + * Permission to use, copy, modify, and/or distribute this software + * for any purpose is hereby granted, under the terms of the MIT license. + * + * If a copy of the license was not distributed with this file, it can + * be obtained from https://opensource.org/licenses/MIT/. + */ + +import customField from '@site/src/libs/customField'; + +export default function HistoryXpm({specifier}): JSX.Element { + return ( + <>The xPack metadata has been added, and the package can now be more conveniently installed via xpm. It is available from npmjs.com as {specifier ? specifier : '@xpack-dev-tools/bison'} + ); +} diff --git a/website/docs/about/_common/HistoryZipAdded/index.tsx b/website/docs/about/_common/HistoryZipAdded/index.tsx new file mode 100644 index 0000000..86d9375 --- /dev/null +++ b/website/docs/about/_common/HistoryZipAdded/index.tsx @@ -0,0 +1,19 @@ +/* + * DO NOT EDIT! + * Automatically generated from xbb-helper/templates/docusaurus/common. + * + * This file is part of the xPack project (http://xpack.github.io). + * Copyright (c) 2024 Liviu Ionescu. All rights reserved. + * + * Permission to use, copy, modify, and/or distribute this software + * for any purpose is hereby granted, under the terms of the MIT license. + * + * If a copy of the license was not distributed with this file, it can + * be obtained from https://opensource.org/licenses/MIT/. + */ + +export default function HistoryZipAdded({platforms}): JSX.Element { + return ( + <>Standard .zip archives were added in parallel with Windows setup files + ); +} diff --git a/website/docs/about/_common/_history-gnu-arm-eclipse.mdx b/website/docs/about/_common/_history-gnu-arm-eclipse.mdx new file mode 100644 index 0000000..be4321e --- /dev/null +++ b/website/docs/about/_common/_history-gnu-arm-eclipse.mdx @@ -0,0 +1,9 @@ +{/* DO NOT EDIT! */} +{/* Automatically generated from xbb-helper/templates/docusaurus/common. */} + +{/* ------------------------------------------------------------------------ */} + +This project began in **{props.date || 'DATE'}** as one of the support tools for the +**GNU Arm Eclipse** plug-ins, +which were later rebranded as **GNU MCU Eclipse** plug-ins and are now +integrated into the [Eclipse Embedded CDT](https://eclipse-embed-cdt.github.io). diff --git a/website/docs/about/_common/_history-rename-xpack.mdx b/website/docs/about/_common/_history-rename-xpack.mdx new file mode 100644 index 0000000..18713bf --- /dev/null +++ b/website/docs/about/_common/_history-rename-xpack.mdx @@ -0,0 +1,9 @@ +{/* DO NOT EDIT! */} +{/* Automatically generated from xbb-helper/templates/docusaurus/common. */} + +import Link from '@docusaurus/Link'; + +{/* ------------------------------------------------------------------------ */} + +The project was renamed **xPack GNU bison** +(in {props.releaseName || 'NAME'}). diff --git a/website/docs/about/_common/_history-restructuring.mdx b/website/docs/about/_common/_history-restructuring.mdx new file mode 100644 index 0000000..2534aeb --- /dev/null +++ b/website/docs/about/_common/_history-restructuring.mdx @@ -0,0 +1,10 @@ +{/* DO NOT EDIT! */} +{/* Automatically generated from xbb-helper/templates/docusaurus/common. */} + +{/* ------------------------------------------------------------------------ */} + +The project underwent a comprehensive restructuring. To streamline the top +`package.json` by showcasing only user-related definitions and concealing +build-related ones, all build-related files were relocated to the +`build-assets` folder. Furthermore, the development Git branch was +renamed to `xpack-development` for enhanced clarity. diff --git a/website/docs/about/_common/_history-setup-discontinued.mdx b/website/docs/about/_common/_history-setup-discontinued.mdx new file mode 100644 index 0000000..b2c8e8f --- /dev/null +++ b/website/docs/about/_common/_history-setup-discontinued.mdx @@ -0,0 +1,12 @@ +{/* DO NOT EDIT! */} +{/* Automatically generated from xbb-helper/templates/docusaurus/common. */} + +import Link from '@docusaurus/Link'; + +{/* ------------------------------------------------------------------------ */} + +To increase flexibility and +allow multiple versions of a tool to be installed on the same system, +the Windows setup format was discontinued. From +version {props.releaseName || 'NAME'} onward, +for Windows, only a standard `.zip` archive was distributed. diff --git a/website/docs/about/_common/_history-xbb-v5.mdx b/website/docs/about/_common/_history-xbb-v5.mdx new file mode 100644 index 0000000..a8139cd --- /dev/null +++ b/website/docs/about/_common/_history-xbb-v5.mdx @@ -0,0 +1,13 @@ +{/* DO NOT EDIT! */} +{/* Automatically generated from xbb-helper/templates/docusaurus/common. */} + +{/* ------------------------------------------------------------------------ */} + +The project received a significant update by transitioning the build +scripts from the cumbersome monolithic XBB Docker images to the more +flexible and modular xPacks. XBB version +[5.0.0](https://xpack.github.io/blog/2023/02/07/xbb-v5.0.0-released/) +marked a major milestone for the xPack project, as it was the first +self-sustained release. This version enabled the creation of new +binary xPacks using existing binary xPacks, eliminating the need for +custom Docker images or other compiled tools. diff --git a/website/docs/about/_common/_intro-primary.mdx b/website/docs/about/_common/_intro-primary.mdx new file mode 100644 index 0000000..0084b81 --- /dev/null +++ b/website/docs/about/_common/_intro-primary.mdx @@ -0,0 +1,8 @@ +{/* DO NOT EDIT! */} +{/* Automatically generated from xbb-helper/templates/docusaurus/common. */} + +{/* ------------------------------------------------------------------------ */} + +The main goal of this project is to streamline the **development of embedded projects**. +[µOS++](http://micro-os-plus.github.io) is the first cross-platform +project to benefit from the xPack tools. diff --git a/website/docs/about/_common/_intro-secondary.mdx b/website/docs/about/_common/_intro-secondary.mdx new file mode 100644 index 0000000..65dfa7a --- /dev/null +++ b/website/docs/about/_common/_intro-secondary.mdx @@ -0,0 +1,11 @@ +{/* DO NOT EDIT! */} +{/* Automatically generated from xbb-helper/templates/docusaurus/common. */} + +{/* ------------------------------------------------------------------------ */} + +This project currently functions as a supplementary tool for building +the primary xPack Development Tools. Since these tools are exclusively +built on macOS and GNU/Linux, to reduce maintenance efforts, for now +there are no Windows binaries. However, the project is versatile and can be +used in any builds; if necessary, Windows binaries can be added in future +releases. diff --git a/website/docs/about/_common/_website-docusaurus-migration.mdx b/website/docs/about/_common/_website-docusaurus-migration.mdx new file mode 100644 index 0000000..11fd0fc --- /dev/null +++ b/website/docs/about/_common/_website-docusaurus-migration.mdx @@ -0,0 +1,12 @@ +{/* DO NOT EDIT! */} +{/* Automatically generated from xbb-helper/templates/docusaurus/common. */} + +{/* ------------------------------------------------------------------------ */} + +In **{props.date || 'DATE'}**, +as part of the project restructuring, the website content was migrated +from the xPack Jekyll sub-site to a local Docusaurus configuration +stored in the `website` folder. To ensure continuity, HTML `` +redirects were added to the old pages. +Additionally, a GitHub Action was implemented to automatically +publish the site upon any pushes to the `website` Git branch. diff --git a/website/docs/about/_common/_website-docusaurus-template.mdx b/website/docs/about/_common/_website-docusaurus-template.mdx new file mode 100644 index 0000000..a6a74e9 --- /dev/null +++ b/website/docs/about/_common/_website-docusaurus-template.mdx @@ -0,0 +1,9 @@ +{/* DO NOT EDIT! */} +{/* Automatically generated from xbb-helper/templates/docusaurus/common. */} + +{/* ------------------------------------------------------------------------ */} + +In **{props.date}** the website content was added in the `website` folder, +as an instance of the Docusaurus template. Additionally a GitHub Action +was added to automatically publish the site upon any pushes to the +`website` Git branch. diff --git a/website/docs/about/_common/_website-jekyll.mdx b/website/docs/about/_common/_website-jekyll.mdx new file mode 100644 index 0000000..571cff7 --- /dev/null +++ b/website/docs/about/_common/_website-jekyll.mdx @@ -0,0 +1,10 @@ +{/* DO NOT EDIT! */} +{/* Automatically generated from xbb-helper/templates/docusaurus/common. */} + +{/* ------------------------------------------------------------------------ */} + +The initial web site was launched in **{props.date || 'DATE'}** as +a sub-site in the xPack web site. +It used the +[Jekyll Doc Theme 6.0](https://idratherbewriting.com/documentation-theme-jekyll/) +by [Tom Johnson](https://github.com/tomjoht). diff --git a/website/docs/about/_history.mdx b/website/docs/about/_history.mdx new file mode 100644 index 0000000..b15009a --- /dev/null +++ b/website/docs/about/_history.mdx @@ -0,0 +1,15 @@ + +import HistoryRestructuring from './_common/_history-restructuring.mdx' + +{/* ------------------------------------------------------------------------ */} + +The project was created in **August 2023**. + +### August 2023 + +The first **xPack GNU bison** release was +[v3.8.2-1](/blog/2023/08/17/bison-v3-8-2-1-released/). + +### August 2024 + + diff --git a/website/docs/about/_more-intro.mdx b/website/docs/about/_more-intro.mdx new file mode 100644 index 0000000..9e48b67 --- /dev/null +++ b/website/docs/about/_more-intro.mdx @@ -0,0 +1,6 @@ + +import IntroSecondary from './_common/_intro-secondary.mdx' + +{/* ------------------------------------------------------------------------ */} + + diff --git a/website/docs/about/_website.mdx b/website/docs/about/_website.mdx new file mode 100644 index 0000000..71cf405 --- /dev/null +++ b/website/docs/about/_website.mdx @@ -0,0 +1,6 @@ + +import WebsiteDocusaurus from './_common/_website-docusaurus-template.mdx' + +{/* ------------------------------------------------------------------------ */} + + diff --git a/website/docs/about/index.mdx b/website/docs/about/index.mdx new file mode 100644 index 0000000..08693ca --- /dev/null +++ b/website/docs/about/index.mdx @@ -0,0 +1,47 @@ +--- + +# DO NOT EDIT! +# Automatically generated from xbb-helper/templates/docusaurus/common. + +title: About the xPack GNU bison + +date: 2024-09-22 10:23:00 +0300 + +--- + +import customField from '@site/src/libs/customField'; +import MoreIntro from './_more-intro.mdx' +import History from './_history.mdx' +import Website from './_website.mdx' + +{/* ------------------------------------------------------------------------ */} + +## The project + +The **xPack GNU bison** project is part of the +[xPack Reproducible Build Framework](https://xpack.github.io) +and is hosted on GitHub as +[`xpack-dev-tools/bison-xpack`](https://github.com/xpack-dev-tools/bison-xpack), +part of the [xPack Binary Development Tools](https://github.com/xpack-dev-tools/). + + + +## Project history + + + +## The web site + + + +## The author + +This project is currently maintained by **Liviu Ionescu** +([ilg-ul](https://github.com/ilg-ul)), +a senior computer engineer, with expertise in **C++/C embedded systems**, +**RTOSes**, **build tools**, operating systems, compilers +and Internet technologies. + +He can be reached at [``](mailto:ilg@livius.net) (this email +address is given for courtesy, for all correspondence related to this +project please use the project [support](/docs/support/) page). diff --git a/website/docs/developer/index.mdx b/website/docs/developer/index.mdx index 3edd90e..a9ff0ca 100644 --- a/website/docs/developer/index.mdx +++ b/website/docs/developer/index.mdx @@ -5,7 +5,7 @@ title: How to build the xPack GNU bison -date: 2024-11-12 20:33:00 +0300 +date: 2024-07-21 20:33:00 +0300 --- diff --git a/website/docs/getting-started/_overview.mdx b/website/docs/getting-started/_overview.mdx index 2525e6a..356aafb 100644 --- a/website/docs/getting-started/_overview.mdx +++ b/website/docs/getting-started/_overview.mdx @@ -1,7 +1,12 @@ {/* ------------------------------------------------------------------------ */} -[GNU bison](https://www.gnu.org/software/bison/) is a general-purpose parser generator that converts an annotated context-free grammar into a deterministic LR or generalized LR (GLR) parser employing LALR parser tables. +The main target of this project is macOS 10.13, as the older version of +this utility fails during some builds. + +[GNU bison](https://www.gnu.org/software/bison/) is a general-purpose parser +generator that converts an annotated context-free grammar into a deterministic +LR or generalized LR (GLR) parser employing LALR parser tables. **GNU bison** is an open source project hosted on [Savannah](https://savannah.gnu.org/projects/bison). diff --git a/website/docs/getting-started/index.mdx b/website/docs/getting-started/index.mdx index 3c2eeff..b3fa2cd 100644 --- a/website/docs/getting-started/index.mdx +++ b/website/docs/getting-started/index.mdx @@ -5,7 +5,7 @@ title: Getting Started with xPack GNU bison -date: 2020-09-28 17:49:00 +0300 +date: 2020-07-21 17:49:00 +0300 --- @@ -24,8 +24,7 @@ import ReleaseSchedule from './_release-schedule.mdx' ## Overview **xPack GNU bison** is a standalone -cross-platform (GNU/Linux, macOS) -binary distribution of GNU bison, +cross-platform (GNU/Linux, macOS)binary distribution of GNU bison, intended for reproducible builds. @@ -135,3 +134,12 @@ corresponding licenses are available in each archive in the ## Releases The list of releases is available in the [Releases](/docs/releases/) pages. + +## Enjoyed Using This Project? Let Us Know! + +If you enjoyed using this project, please let us know! Here are some ways you can show your support: + +- **Donate**: Your contributions (small or +generous) help us keep the xPack projects thriving. [![Donate](https://www.paypalobjects.com/en_US/i/btn/btn_donate_SM.gif)](https://www.paypal.com/donate/?hosted_button_id=5MFRG9ZRBETQ8) +- **Star** the project on [GitHub](https://github.com/xpack-dev-tools/bison-xpack/): It helps others discover our work. +- **Follow** us on [X/Twitter](https://twitter.com/xpack_project/): Stay updated with our latest releases and news. diff --git a/website/docs/install/index.mdx b/website/docs/install/index.mdx index 247b424..e69e5e0 100644 --- a/website/docs/install/index.mdx +++ b/website/docs/install/index.mdx @@ -7,7 +7,7 @@ title: How to install the xPack GNU bison binaries hide_table_of_contents: false -date: 2020-09-27 11:09:00 +0300 +date: 2020-08-21 11:09:00 +0300 --- @@ -225,6 +225,14 @@ The next step is to install the `xpm install @xpack-dev-tools/bison@latest --verbose `} +This command will install the latest available version. + +To install a specific version, mention it explicitly: + + { +`xpm install @xpack-dev-tools/bison@${customField('version')} --verbose +`} + diff --git a/website/docs/maintainer/index.mdx b/website/docs/maintainer/index.mdx index ad1d148..f3d5837 100644 --- a/website/docs/maintainer/index.mdx +++ b/website/docs/maintainer/index.mdx @@ -5,7 +5,7 @@ title: How to make new xPack GNU bison releases -date: 2024-07-12 20:11:00 +0300 +date: 2024-07-21 20:11:00 +0300 --- @@ -852,7 +852,7 @@ version in `package.json` is not changed. :::note -Avoid further updates to the `xpack` branch until the next release. +Avoid further updates to the `xpack` branch until the next release. ::: diff --git a/website/docs/releases/index.md b/website/docs/releases/index.md index 31adca1..50c1adc 100644 --- a/website/docs/releases/index.md +++ b/website/docs/releases/index.md @@ -7,7 +7,7 @@ title: The xPack GNU bison releases hide_table_of_contents: true -date: 2020-09-28 17:53:00 +0300 +date: 2020-07-21 17:53:00 +0300 --- diff --git a/website/docs/support/index.mdx b/website/docs/support/index.mdx index b964e55..d80c40d 100644 --- a/website/docs/support/index.mdx +++ b/website/docs/support/index.mdx @@ -5,7 +5,7 @@ title: How to get help for xPack GNU bison -date: 2020-09-28 17:54:00 +0300 +date: 2020-07-21 17:54:00 +0300 --- diff --git a/website/docs/user/index.mdx b/website/docs/user/index.mdx index e91c0d3..e6f7a41 100644 --- a/website/docs/user/index.mdx +++ b/website/docs/user/index.mdx @@ -5,7 +5,7 @@ title: How to use the xPack GNU bison -date: 2024-07-11 18:56:00 +0300 +date: 2024-07-21 18:56:00 +0300 --- diff --git a/website/docusaurus.config.ts b/website/docusaurus.config.ts index e7262fb..f27848f 100644 --- a/website/docusaurus.config.ts +++ b/website/docusaurus.config.ts @@ -61,13 +61,6 @@ function getCustomFields() { upstreamVersion = xpackSemver; } - const websiteFilePath = path.join(path.dirname(path.dirname(pwd)), 'website', 'package.json'); - // logger.info(filePath); - const websiteFileContent = fs.readFileSync(websiteFilePath); - const websitePackageJson = JSON.parse(websiteFileContent.toString()); - - const docusaurusVersion = websitePackageJson.dependencies['@docusaurus/core'].replace ('^', ''); - return { appName: rootPackageJson.xpack.properties.appName, appLcName: rootPackageJson.xpack.properties.appLcName, @@ -77,7 +70,8 @@ function getCustomFields() { xpackSubversion, npmSubversion, upstreamVersion, - docusaurusVersion, + docusaurusVersion: require('@docusaurus/core/package.json').version, + buildTime: new Date().getTime(), ...customFields, } } @@ -272,6 +266,10 @@ const config: Config = { { label: 'Releases', to: '/docs/releases' + }, + { + label: 'About', + to: '/docs/about' } ] }, @@ -302,9 +300,9 @@ const config: Config = { 'aria-label': 'GitHub repository', }, { - label: `v${customFields.upstreamVersion}-${customFields.xpackSubversion}`, + label: `v${customFields.xpackVersion}`, position: 'right', - href: `https://github.com/xpack-dev-tools/bison-xpack/releases/tag/v${customFields.upstreamVersion}-${customFields.xpackSubversion}`, + href: `https://github.com/xpack-dev-tools/bison-xpack/releases/tag/v${customFields.xpackVersion}`, }, { href: 'https://github.com/xpack-dev-tools/', @@ -322,7 +320,7 @@ const config: Config = { style: 'dark', links: [ { - title: 'Docs', + title: 'Pages', items: [ { label: 'Install', @@ -336,11 +334,19 @@ const config: Config = { label: 'Releases', to: '/docs/releases', }, + { + label: 'Blog', + to: '/blog', + }, ], }, { title: 'Community', items: [ + { + label: 'GitHub Discussions', + href: 'https://github.com/xpack-dev-tools/bison-xpack/discussions', + }, { label: 'Stack Overflow', href: 'https://stackoverflow.com/questions/tagged/xpack', @@ -350,7 +356,7 @@ const config: Config = { href: 'https://discord.gg/kbzWaJerFG', }, { - label: 'Twitter', + label: 'X/Twitter', href: 'https://twitter.com/xpack_project', }, ], @@ -359,8 +365,8 @@ const config: Config = { title: 'More', items: [ { - label: 'Blog', - to: '/blog', + label: 'Donate via PayPal', + href: 'https://www.paypal.com/donate/?hosted_button_id=5MFRG9ZRBETQ8', }, { label: 'GitHub bison-xpack', @@ -377,7 +383,7 @@ const config: Config = { ], }, ], - copyright: `Copyright © ${new Date().getFullYear()} Liviu Ionescu. Built with Docusaurus.`, + copyright: `Copyright © ${new Date().getFullYear()} Liviu Ionescu. Built with Docusaurus v${customFields.docusaurusVersion} on ${new Date(customFields.buildTime).toDateString()}.`, }, prism: { theme: prismThemes.github, diff --git a/website/i18n/en/docusaurus-theme-classic/footer.json b/website/i18n/en/docusaurus-theme-classic/footer.json index dd9adde..332d91a 100644 --- a/website/i18n/en/docusaurus-theme-classic/footer.json +++ b/website/i18n/en/docusaurus-theme-classic/footer.json @@ -32,7 +32,7 @@ "description": "The label of footer link with label=Discord linking to https://discord.gg/kbzWaJerFG" }, "link.item.label.Twitter": { - "message": "Twitter", + "message": "X/Twitter", "description": "The label of footer link with label=Twitter linking to https://twitter.com/xpack_project" }, "link.item.label.Blog": { @@ -46,9 +46,5 @@ "link.item.label.xpack-dev-tools": { "message": "xpack-dev-tools", "description": "The label of footer link with label=xpack-dev-tools linking to https://github.com/xpack-dev-tools/" - }, - "copyright": { - "message": "Copyright © 2024 Liviu Ionescu. Built with Docusaurus.", - "description": "The footer copyright" } } diff --git a/website/sidebars.ts b/website/sidebars.ts index cc95863..1ce0745 100644 --- a/website/sidebars.ts +++ b/website/sidebars.ts @@ -49,6 +49,11 @@ const sidebars: SidebarsConfig = { id: 'releases/index', label: 'Releases' }, + { + type: 'doc', + id: 'about/index', + label: 'About' + }, { type: 'doc', id: 'developer/index', diff --git a/website/src/components/HomepageFeatures/index.tsx b/website/src/components/HomepageFeatures/index.tsx index a265904..ebb2268 100644 --- a/website/src/components/HomepageFeatures/index.tsx +++ b/website/src/components/HomepageFeatures/index.tsx @@ -28,11 +28,10 @@ const FeatureList: FeatureItem[] = [ Svg: require('@site/static/img/mosaic.svg').default, description: ( <> - By design, multiple versions of the same tools - can be installed - at the same time on the same system. Windows, macOS, GNU/Linux are - supported. The tools include all - required libraries and can be installed in any folder. + By design, multiple versions of the same tools can be + installed at the same time on the same + system. The supported platforms are: GNU/Linux, macOS. + The tools include all required libraries and can be installed in any folder. ), }, diff --git a/website/src/components/HomepageFeatures/styles.module.css b/website/src/components/HomepageFeatures/styles.module.css index 45dce2b..bac1b99 100644 --- a/website/src/components/HomepageFeatures/styles.module.css +++ b/website/src/components/HomepageFeatures/styles.module.css @@ -1,9 +1,8 @@ /* * DO NOT EDIT! * Automatically generated from xbb-helper/templates/docusaurus/common. - * */ - + .features { display: flex; align-items: center; diff --git a/website/src/css/custom.css b/website/src/css/custom.css index f0da361..1a5a817 100644 --- a/website/src/css/custom.css +++ b/website/src/css/custom.css @@ -97,5 +97,3 @@ h2[class*="title"] background: url("data:image/svg+xml,%3Csvg viewBox='0 0 24 24' xmlns='http://www.w3.org/2000/svg'%3E%3Cpath fill='white' d='M12 .297c-6.63 0-12 5.373-12 12 0 5.303 3.438 9.8 8.205 11.385.6.113.82-.258.82-.577 0-.285-.01-1.04-.015-2.04-3.338.724-4.042-1.61-4.042-1.61C4.422 18.07 3.633 17.7 3.633 17.7c-1.087-.744.084-.729.084-.729 1.205.084 1.838 1.236 1.838 1.236 1.07 1.835 2.809 1.305 3.495.998.108-.776.417-1.305.76-1.605-2.665-.3-5.466-1.332-5.466-5.93 0-1.31.465-2.38 1.235-3.22-.135-.303-.54-1.523.105-3.176 0 0 1.005-.322 3.3 1.23.96-.267 1.98-.399 3-.405 1.02.006 2.04.138 3 .405 2.28-1.552 3.285-1.23 3.285-1.23.645 1.653.24 2.873.12 3.176.765.84 1.23 1.91 1.23 3.22 0 4.61-2.805 5.625-5.475 5.92.42.36.81 1.096.81 2.22 0 1.606-.015 2.896-.015 3.286 0 .315.21.69.825.57C20.565 22.092 24 17.592 24 12.297c0-6.627-5.373-12-12-12'/%3E%3C/svg%3E") no-repeat; } - -