Skip to content

Commit 17bd82a

Browse files
committed
add website
1 parent 8c82eb2 commit 17bd82a

File tree

86 files changed

+21545
-0
lines changed

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

86 files changed

+21545
-0
lines changed

website/.gitignore

Lines changed: 20 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,20 @@
1+
# Dependencies
2+
/node_modules
3+
4+
# Production
5+
/build
6+
7+
# Generated files
8+
.docusaurus
9+
.cache-loader
10+
11+
# Misc
12+
.DS_Store
13+
.env.local
14+
.env.development.local
15+
.env.test.local
16+
.env.production.local
17+
18+
npm-debug.log*
19+
yarn-debug.log*
20+
yarn-error.log*

website/README.md

Lines changed: 10 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,10 @@
1+
# Website
2+
3+
This website is built using [Docusaurus](https://docusaurus.io/),
4+
a modern static website generator.
5+
6+
The folder was created with:
7+
8+
```bash
9+
npx create-docusaurus website classic --typescript
10+
```

website/authors.yml

Lines changed: 8 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,8 @@
1+
# DO NOT EDIT!
2+
# Automatically generated from xbb-helper/templates/docusaurus/common.
3+
4+
ilg-ul:
5+
name: Liviu Ionescu (ilg)
6+
7+
url: https://github.com/ilg-ul
8+
image_url: https://github.com/ilg-ul.png

website/babel.config.js

Lines changed: 6 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,6 @@
1+
// DO NOT EDIT!
2+
// Automatically generated from xbb-helper/templates/docusaurus/common.
3+
4+
module.exports = {
5+
presets: [require.resolve('@docusaurus/core/lib/babel/preset')],
6+
};
Lines changed: 40 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,40 @@
1+
2+
{/* DO NOT EDIT! */}
3+
{/* Automatically generated from xbb-helper/templates/docusaurus/common. */}
4+
5+
{/* ------------------------------------------------------------------------ */}
6+
7+
## Deprecation notices
8+
9+
### Linux minimum requirements
10+
11+
The minimum requirement is **GLIBC 2.27**, available starting
12+
with Ubuntu 18, Debian 10 and RedHat 8.
13+
Support for RedHat 7 was dropped in 2022.
14+
15+
### 32-bit support
16+
17+
Support for 32-bit Intel Linux and Intel Windows was
18+
dropped in 2022.
19+
20+
### Pre-deprecation notice for 32-bit Arm Linux
21+
22+
Due to the large user base of 32-bit Raspberry Pi systems,
23+
support for 32-bit Arm Linux (armv7l) will be preserved
24+
for a little while, but expect it to be dropped by 2025,
25+
so it is recommended to consider an upgrade to a RPi 4 or 5 with
26+
at least 4 GB (preferably 8 GB) of RAM.
27+
28+
## Pre-deprecation notice for Ubuntu 18.04
29+
30+
Ubuntu 18.04 LTS _Bionic Beaver_ reached the end of the standard five-year
31+
maintenance window for Long-Term Support (LTS) release on 31 May 2023.
32+
33+
As a courtesy, the xPack GNU/Linux releases will continue to be based on
34+
Ubuntu 18.04 for another year.
35+
36+
From 2025 onwards, the GNU/Linux binaries will be built on **Debian 10**,
37+
(**GLIBC 2.28**), and are also expected to run on RedHat 8.
38+
39+
Users are urged to update their build and test infrastructure to
40+
ensure a smooth transition to the next xPack releases.
Lines changed: 20 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,20 @@
1+
{/* DO NOT EDIT! */}
2+
{/* Automatically generated from xbb-helper/templates/docusaurus/common. */}
3+
4+
import Image from '@theme/IdealImage';
5+
6+
{/* ------------------------------------------------------------------------ */}
7+
8+
## Analytics
9+
10+
- GitHub [xpack-dev-tools/qemu-riscv-xpack](https://github.com/xpack-dev-tools/qemu-riscv-xpack/)
11+
- this release <a href={`https://github.com/xpack-dev-tools/qemu-riscv-xpack/releases/v${props.version}/`} ><Image img={`https://img.shields.io/github/downloads/xpack-dev-tools/qemu-riscv-xpack/v${props.version}/total.svg`} alt='Github Release' /></a>
12+
- all xPack releases [![Github All Releases](https://img.shields.io/github/downloads/xpack-dev-tools/qemu-riscv-xpack/total.svg)](https://github.com/xpack-dev-tools/qemu-riscv-xpack/releases/)
13+
- [individual file counters](https://somsubhra.github.io/github-release-stats/?username=xpack-dev-tools&repository=qemu-riscv-xpack) (grouped by release)
14+
- npmjs.com [@xpack-dev-tools/qemu-riscv](https://www.npmjs.com/package/@xpack-dev-tools/qemu-riscv)
15+
- latest releases [![npm](https://img.shields.io/npm/dw/@xpack-dev-tools/qemu-riscv.svg)](https://www.npmjs.com/package/@xpack-dev-tools/qemu-riscv/)
16+
- all @xpack-dev-tools releases [![npm](https://img.shields.io/npm/dt/@xpack-dev-tools/qemu-riscv.svg)](https://www.npmjs.com/package/@xpack-dev-tools/qemu-riscv/)
17+
18+
Credit to [Shields IO](https://shields.io) for the badges and to
19+
[Somsubhra/github-release-stats](https://github.com/Somsubhra/github-release-stats)
20+
for the individual file counters.
Lines changed: 18 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,18 @@
1+
{/* DO NOT EDIT! */}
2+
{/* Automatically generated from xbb-helper/templates/docusaurus/common. */}
3+
4+
{/* ------------------------------------------------------------------------ */}
5+
6+
## Prerequisites
7+
8+
- x64 GNU/Linux: any system with **GLIBC 2.27** or higher
9+
(like Ubuntu 18 or later, Debian 10 or later, RedHat 8 or later,
10+
Fedora 29 or later, etc)
11+
- arm64/arm GNU/Linux: any system with **GLIBC 2.27** or higher
12+
(like Raspberry Pi OS, Ubuntu 18 or later, Debian 10 or later,
13+
RedHat 8 or later, Fedora 29 or later, etc)
14+
- x64 Windows: Windows 7 with the Universal C Runtime
15+
([UCRT](https://support.microsoft.com/en-us/topic/update-for-universal-c-runtime-in-windows-c0514201-7fe6-95a3-b0a5-287930f3560c)),
16+
Windows 8, Windows 10, Windows 11
17+
- x64 macOS: 10.13 or later
18+
- arm64 macOS: 11.6 or later
Lines changed: 57 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,57 @@
1+
{/* DO NOT EDIT! */}
2+
{/* Automatically generated from xbb-helper/templates/docusaurus/common. */}
3+
4+
import CodeBlock from '@theme/CodeBlock';
5+
6+
import customField from '@site/src/libs/customField';
7+
import {developmentDurations} from '../../maintainer/_development-durations.mdx'
8+
9+
{/* ------------------------------------------------------------------------ */}
10+
11+
{/* Arguments: props.platform */}
12+
13+
{props.platform == "win32-x64" ? ( <p>The Windows builds run on GNU/Linux, using <a href="https://mingw-w64.org">mingw-w64</a>.</p> ) : ''}
14+
15+
To prepare the docker build:
16+
17+
<CodeBlock language="sh"> {
18+
`xpm run install -C ~/Work/xpack-dev-tools/qemu-riscv-xpack.git/build-assets && \\
19+
xpm run docker-prepare --config ${props.platform} -C ~/Work/xpack-dev-tools/qemu-riscv-xpack.git/build-assets
20+
`} </CodeBlock>
21+
22+
<details>
23+
<summary>... or, with the writable helper ...</summary>
24+
25+
<CodeBlock language="sh"> {
26+
`xpm run install -C ~/Work/xpack-dev-tools/qemu-riscv-xpack.git/build-assets && \\
27+
xpm run link-deps -C ~/Work/xpack-dev-tools/qemu-riscv-xpack.git/build-assets && \\
28+
xpm run docker-prepare --config ${props.platform} -C ~/Work/xpack-dev-tools/qemu-riscv-xpack.git/build-assets && \\
29+
xpm run docker-link-deps --config ${props.platform} -C ~/Work/xpack-dev-tools/qemu-riscv-xpack.git/build-assets
30+
`} </CodeBlock>
31+
32+
</details>
33+
34+
To run the docker build:
35+
36+
<CodeBlock language="sh"> {
37+
`xpm run docker-build --config ${props.platform} -C ~/Work/xpack-dev-tools/qemu-riscv-xpack.git/build-assets
38+
`} </CodeBlock>
39+
40+
or, for more verbosity, run the similar development build:
41+
42+
<CodeBlock language="sh"> {
43+
`xpm run docker-build-development --config ${props.platform} -C ~/Work/xpack-dev-tools/qemu-riscv-xpack.git/build-assets
44+
`} </CodeBlock>
45+
46+
{developmentDurations[ props.platform ]}, the output of the build script is a compressed
47+
archive and its SHA signature, created in
48+
the <code>buils-assets/build/{props.platform}/deploy</code> folder:
49+
50+
* <code>xpack-qemu-riscv-{customField('upstreamVersion')}-{customField('xpackSubversion')}-{props.platform}.tar.gz</code>
51+
* <code>xpack-qemu-riscv-{customField('upstreamVersion')}-{customField('xpackSubversion')}-{props.platform}.tar.gz.sha</code>
52+
53+
To rerun the build, invoke the **deep-clean** action and repeat from install:
54+
55+
<CodeBlock language="sh"> {
56+
`xpm run deep-clean --config ${props.platform} -C ~/Work/xpack-dev-tools/qemu-riscv-xpack.git/build-assets
57+
`} </CodeBlock>
Lines changed: 54 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,54 @@
1+
{/* DO NOT EDIT! */}
2+
{/* Automatically generated from xbb-helper/templates/docusaurus/common. */}
3+
4+
import CodeBlock from '@theme/CodeBlock';
5+
6+
import customField from '@site/src/libs/customField';
7+
import {developmentDurations} from '../../maintainer/_development-durations.mdx'
8+
9+
{/* ------------------------------------------------------------------------ */}
10+
11+
{/* Arguments: props.platform */}
12+
13+
To prepare the native build:
14+
15+
<CodeBlock language="sh"> {
16+
`xpm run install -C ~/Work/xpack-dev-tools/qemu-riscv-xpack.git/build-assets && \\
17+
xpm install --config ${props.platform} -C ~/Work/xpack-dev-tools/qemu-riscv-xpack.git/build-assets
18+
`} </CodeBlock>
19+
20+
<details>
21+
<summary>... or, with the writable helper ...</summary>
22+
23+
<CodeBlock language="sh"> {
24+
`xpm run install -C ~/Work/xpack-dev-tools/qemu-riscv-xpack.git/build-assets && \\
25+
xpm run link-deps -C ~/Work/xpack-dev-tools/qemu-riscv-xpack.git/build-assets && \\
26+
xpm install --config ${props.platform} -C ~/Work/xpack-dev-tools/qemu-riscv-xpack.git/build-assets
27+
`} </CodeBlock>
28+
29+
</details>
30+
31+
To run the native build:
32+
33+
<CodeBlock language="sh"> {
34+
`xpm run build --config ${props.platform} -C ~/Work/xpack-dev-tools/qemu-riscv-xpack.git/build-assets
35+
`} </CodeBlock>
36+
37+
or, for more verbosity, run the similar development build:
38+
39+
<CodeBlock language="sh"> {
40+
`xpm run build-development --config ${props.platform} -C ~/Work/xpack-dev-tools/qemu-riscv-xpack.git/build-assets
41+
`} </CodeBlock>
42+
43+
{developmentDurations[ props.platform ]}, the output of the build script is a compressed
44+
archive and its SHA signature, created in
45+
the <code>buils-assets/build/{props.platform}/deploy</code> folder:
46+
47+
* <code>xpack-qemu-riscv-{customField('upstreamVersion')}-{customField('xpackSubversion')}-{props.platform}.tar.gz</code>
48+
* <code>xpack-qemu-riscv-{customField('upstreamVersion')}-{customField('xpackSubversion')}-{props.platform}.tar.gz.sha</code>
49+
50+
To rerun the build, invoke the **deep-clean** action and repeat from install:
51+
52+
<CodeBlock language="sh"> {
53+
`xpm run deep-clean --config ${props.platform} -C ~/Work/xpack-dev-tools/qemu-riscv-xpack.git/build-assets
54+
`} </CodeBlock>

website/docs/developer/_more.mdx

Lines changed: 6 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,6 @@
1+
2+
import CodeBlock from '@theme/CodeBlock';
3+
4+
import customField from '@site/src/libs/customField';
5+
6+
{/* ------------------------------------------------------------------------ */}

0 commit comments

Comments
 (0)