Skip to content
Open
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
4 changes: 4 additions & 0 deletions .gitignore
Original file line number Diff line number Diff line change
@@ -0,0 +1,4 @@
components/ai/
components/button.tsx
components/card3.tsx
components/toc.tsx
60 changes: 6 additions & 54 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -14,59 +14,11 @@ The easiest way to start contributing is to find the `.mdx` file that is used to

In case you want to generate the static pages locally (could be useful for large changes) see below.

1. Clone CERIT repo with some objects common to all eInfra docs: `git clone https://github.com/CERIT-SC/fumadocs` (you can do this only once, you just need to have the repo content somewhere.) There are several files that are needed to compile the docs, however they should not be copied to the repo and should be only used temporarily (ask Lukas Hejtmanek if in doubt).

2. Clone the Metacentrum docs repo, checkout to the main branch:

```
git clone https://github.com/CESNET/metacentrum-user-docs

git checkout remotes/origin/main

# or you can make the remote branch local as:
git checkout -b main origin/main

```

3. Make a small script similar to the following:

1. Clone the CESNET/metacentrum-user-docs repo `git clone https://github.com/CESNET/metacentrum-user-docs`
2. Clone CERIT-SC/fumadocs repo with some objects common to all eInfra docs: `git clone https://github.com/CERIT-SC/fumadocs`
3. Copy the required files `cp -r fumadocs/components/* metacentrum-user-docs/components/`
4. Run the build
```bash
#!/bin/bash

# path to where the Metacentrum docs repo
repodir="/home/melounova/meta/metacentrum-user-docs"

# path to the CERIT fumadocs repo
fumadir="/home/melounova/meta/fumadocs"

# Copy some stuff from CERIT repo to Metacentrum repo
cd ${repodir}/components
cp -r ${fumadir}/components/* .
cd ${repodir}

# run the build
docker run -it --rm -p 3000:3000 -e STARTPAGE=/en/docs -v ${repodir}/public:/opt/fumadocs/public -v ${repodir}/components:/opt/fumadocs/components -v ${repodir}/content/docs:/opt/fumadocs/content/docs cerit.io/docs/fuma:v15.0.12 pnpm dev

# remove again the stuff borrowed from CERIT repo
cd ${repodir}/components ; rm -r ai ; rm button.tsx card3.tsx sidebar.tsx toc.tsx
docker run -it --rm -p 3000:3000 -e STARTPAGE=/en/docs -v metacentrum-user-docs/public:/opt/fumadocs/public -v metacentrum-user-docs/components:/opt/fumadocs/components -v metacentrum-user-docs/content/docs:/opt/fumadocs/content/docs cerit.io/docs/fuma:v16.4.6 pnpm dev
```

4. run the script (as sudo if needed); in a browser, see the docs at `http://localhost:3000/en/docs/welcome`


**Notes**

- 8 GB of mem is just barely enough to run the build on an older ntb













5. Documentation will be available at `http://localhost:3000/en/docs/welcome` and automatically rebuilt on source change
2 changes: 1 addition & 1 deletion content/docs/access/account.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -27,7 +27,7 @@ Expired accounts can be renewed at any time during the year [here](https://metav

## How to start with MetaCentrum

A comprehensive tutorial for new users is [here](https://docs.metacentrum.cz/en/docs/computing/basic-tutorial).
A comprehensive tutorial for new users is [here](https://docs.metacentrum.cz/en/docs/computing/run-basic-job).

## Group data access

Expand Down
Loading