Go to file
Denis 'GNUtoo' Carikli 3e9180a277
Convert to autotools to enable configuring the lbwww directory
Using autotools has several advantages against trying to add such a
feature to the Makefile:
- we don't need to always pass an extra option to make, so once
  configured there is less to type
- we also check for dependencies along the way
- the trade-off between easy to use and code simplicity looks better
  than with plain Makefile: with a single option we can easily make
  the Makefile use --share and --with-lbwww-path conditionally. Doing
  that with a plain Makefile would probably be way more complex, or
  would require code duplication (to only use --share and
  --with-lbwww-path when an option is passed to the Makefile), or
  would require to pass raw build.sh options (which would complicate
  usage).

Signed-off-by: Denis 'GNUtoo' Carikli <GNUtoo@cyberdimension.org>
Acked-by: Adrien 'neox' Bourmault <neox@a-lec.org>
2023-03-23 01:55:59 +01:00
.gitignore Convert to autotools to enable configuring the lbwww directory 2023-03-23 01:55:59 +01:00
COPYING Initial import 2022-11-22 20:33:08 +01:00
Makefile.am Convert to autotools to enable configuring the lbwww directory 2023-03-23 01:55:59 +01:00
README Convert to autotools to enable configuring the lbwww directory 2023-03-23 01:55:59 +01:00
autogen.sh Convert to autotools to enable configuring the lbwww directory 2023-03-23 01:55:59 +01:00
build.sh build.sh: Add --with-lbwww-path to use a local lbwww git repository 2023-03-23 01:53:35 +01:00
configure.ac Convert to autotools to enable configuring the lbwww directory 2023-03-23 01:55:59 +01:00
lighttpd.conf.tmpl Add the ability to test the website locally 2022-11-24 02:35:06 +01:00
serve.sh Add the ability to test the website locally 2022-11-24 02:35:06 +01:00

README

== Introduction ==
This project enables to easily build and deploy the Libreboot website.

== Local deployments ==
For local deployments you just need to extract the tarball in a
webroot and have a web server serve that content.

== Deployment on Sourcehut ==
Sourcehut has a way to setup a static website by uploading a tarball
of the content. Users that want to deploy a website there are expected
to follow the official documentation[1] to generate a token and add
this token to the id_oauth2_bearer file in the current directory.

To generate the token, you need to log in and then go on the
https://meta.sr.ht/oauth2/personal-token page. Once there you need to
go in "Limit scope of access grant" and to select at least SITES,
otherwise it won't work (it would fail with the "The specified key
does not exist." message).

[1]https://srht.site/quickstart

== Dependencies ==
* autoconf
* automake
* coreutils
* curl: for uploading the website to sourcehut
* guix
* make
* tar

== License ==
This project is free software: you can redistribute it and/or modify
it under the terms of the GNU General Public License as published by
the Free Software Foundation, either version 3 of the License, or
(at your option) any later version.