All of lore.kernel.org
 help / color / mirror / Atom feed
From: Philippe Gerum <rpm@xenomai.org>
To: Per Oberg <pero@wolfram.com>
Cc: xenomai@lists.linux.dev
Subject: Re: Xenomai Wiki updates
Date: Mon, 04 Sep 2023 14:35:01 +0200	[thread overview]
Message-ID: <87fs3up0dg.fsf@xenomai.org> (raw)
In-Reply-To: <295930955.1965703.1693822486006.JavaMail.zimbra@wolfram.com>


Per Oberg <pero@wolfram.com> writes:

> Hi
>
> I was looking at the Xenomai Wiki and noticed that there were some outdated information.
>
> E.g. : 
>
> * https://source.denx.de/Xenomai/xenomai/-/wikis/Installing_Xenomai_3
> Dovetail, kernel git trees and recommendations are not mentioned. There is a section on the powerpc part which I seem to remember has been deprecated. 
>
>  
> * https://source.denx.de/Xenomai/xenomai/-/wikis/Start_Here
> Embedded Linux distributions & Xenomai points to ELDK which seems to be no longer available. 
>

Significant updates to the v3 documentation is direly needed for sure.

>
> I think I might find some time update some of the stuff. What are the guidelines and procedure to contribute to th Wiki ?
>

The content of the upcoming website at v3.xenomai.org is maintained in a
git tree, which is now public. This is a Hugo generated (static) site
using the 'learn' theme, see [2][3]. Likewise for Xenomai 4/evl at
v4.xenomai.org, content available as a git tree from [4].

The workflow is pretty simple:

- apt/dnf install the 'hugo' package
- git clone the website repo
- make changes to $repo/content/*

hugo provides a local web server [5] serving the pages in $repo to a
local browser, which automatically renders any update live:

- cd $repo
- hugo server

The website should be accessible from localhost:1313.

Contributions are welcome, patches should be sent to this list.

[1] https://source.denx.de/Xenomai/website.git
[2] https://gohugo.io/
[3] https://learn.netlify.app/en/
[4] https://source.denx.de/Xenomai/xenomai4/website.git
[5] https://gohugo.io/commands/hugo_server/

-- 
Philippe.

      parent reply	other threads:[~2023-09-04 12:51 UTC|newest]

Thread overview: 7+ messages / expand[flat|nested]  mbox.gz  Atom feed  top
2023-09-04 10:14 Xenomai Wiki updates Per Oberg
2023-09-04 12:20 ` Jan Kiszka
2023-09-12 15:30   ` Per Oberg
2023-09-12 15:47     ` Per Oberg
2023-09-12 17:21       ` Jan Kiszka
2023-09-13  6:14         ` Per Oberg
2023-09-04 12:35 ` Philippe Gerum [this message]

Reply instructions:

You may reply publicly to this message via plain-text email
using any one of the following methods:

* Save the following mbox file, import it into your mail client,
  and reply-to-all from there: mbox

  Avoid top-posting and favor interleaved quoting:
  https://en.wikipedia.org/wiki/Posting_style#Interleaved_style

* Reply using the --to, --cc, and --in-reply-to
  switches of git-send-email(1):

  git send-email \
    --in-reply-to=87fs3up0dg.fsf@xenomai.org \
    --to=rpm@xenomai.org \
    --cc=pero@wolfram.com \
    --cc=xenomai@lists.linux.dev \
    /path/to/YOUR_REPLY

  https://kernel.org/pub/software/scm/git/docs/git-send-email.html

* If your mail client supports setting the In-Reply-To header
  via mailto: links, try the mailto: link
Be sure your reply has a Subject: header at the top and a blank line before the message body.
This is an external index of several public inboxes,
see mirroring instructions on how to clone and mirror
all data and code used by this external index.