Bug#807954: debian-live: setup automated builds of live-manual

2023-03-23 Thread Roland Clobus

Hello Holger,

On 17/03/2023 21:17, Holger Wansing wrote:

Is there still interest to get the live-manual built on official Debian
machines / included on the Debian website?


Yes.


In this case, I would vote for using the same mechanism as currently used
for all the other documents under www.debian.org/doc.


Good idea.


To get a manual updated on the Debian website, one just needs to upload a
new version to unstable, and the rest is done auto-magic-ally :-)


Currently the latest and greatest version is automatically generated by 
Salsa on every git commit.


https://live-team.pages.debian.net/live-manual/html/live-manual/index.en.html

The last release of the package was in 2015... so a new package upload 
is due.



I have prepared (and tested) patches for both; attached.


I'll fill in the missing spots soon.

With kind regards,
Roland


OpenPGP_signature
Description: OpenPGP digital signature


Bug#807954: debian-live: setup automated builds of live-manual

2023-03-17 Thread Holger Wansing

> Package: debian-live
> Severity: normal
> 
> Hi,
> 
> The old server providing live.debian.net has been shutdown. The hosted
> versions of the live-manual package should now be located on the
> debian-live group's Alioth webspace instead now.

Is there still interest to get the live-manual built on official Debian
machines / included on the Debian website?

In this case, I would vote for using the same mechanism as currently used
for all the other documents under www.debian.org/doc.
That is: the documents are not being built in particular for the debian website;
instead, their respective binary packages from unstable are unpacked, relevant 
files (mostly .html or .pdf) are copied to the correct directory, sometimes
renamed, and that's it.

To get a manual updated on the Debian website, one just needs to upload a
new version to unstable, and the rest is done auto-magic-ally :-)



To make this happen, changes for two git repos are needed:
https://salsa.debian.org/webmaster-team/cron
and
https://salsa.debian.org/webmaster-team/webwml


I have prepared (and tested) patches for both; attached.

That would add the 'all-in-one-html-file' variant of live-manual to
https://www.debian.org/doc/devel-manuals

I have also added a built of the devel-manuals html page, to give an idea,
how it might look like.


Regards

Holger




-- 
Holger Wansing 
PGP-Fingerprint: 496A C6E8 1442 4B34 8508  3529 59F1 87CA 156E B076
diff --git a/parts/1ftpfiles b/parts/1ftpfiles
index bb8bdb0..8d38dce 100755
--- a/parts/1ftpfiles
+++ b/parts/1ftpfiles
@@ -94,6 +94,7 @@ getdeb all debian-refcard
 getdeb amd64 build-essential
 getdeb amd64 menu
 getdeb amd64 python3-dev
+getdeb amd64 live-manual-html
 
 # Files in $crondir/ftpfiles/doc are not used any more ???
 # This should make clear if someone tries and fails.
diff --git a/parts/7doc b/parts/7doc
index 9d7421f..c2c742d 100755
--- a/parts/7doc
+++ b/parts/7doc
@@ -620,6 +620,18 @@ for lang in $langlist ; do
 done
 fi
 
+unpack live-manual-html
+if [ ! -e $ftpdir/${dist}/live-manual-html.skip ]; then
+langlist=`file2lang live-manual .html usr/share/doc/live-manual/html`
+for lang in $langlist ; do
+	mvhtml live-manual/html usr/share/doc/live-manual/html YES $lang
+	mv $webdocdir/manuals/live-manual/html/live-manual.$lang.html $webdocdir/manuals/live-manual/html/index.$lang.html
+done
+mv usr/share/doc/live-manual/_sisu $webdocdir/manuals/live-manual/_sisu
+fi
+
+
+
 # Move broken code segment here for debug
 #echo
 #echo "7doc start debug (at `date`)"
diff --git a/english/doc/devel-manuals.defs b/english/doc/devel-manuals.defs
index 4a789a21abc..7bc102528fb 100644
--- a/english/doc/devel-manuals.defs
+++ b/english/doc/devel-manuals.defs
@@ -83,3 +83,14 @@
 vcsrepo="https://salsa.debian.org/debian/dbconfig-common.git;
 />
 
+
+
+  https://salsa.debian.org/live-team/live-manual;
+vcsrepo="https://salsa.debian.org/live-team/live-manual.git;
+/>
+
diff --git a/english/doc/devel-manuals.wml b/english/doc/devel-manuals.wml
index ac0923d903e..1d113c81caf 100644
--- a/english/doc/devel-manuals.wml
+++ b/english/doc/devel-manuals.wml
@@ -260,3 +260,29 @@ package, and packaging the gnujump game and a Java library.
 
 
 
+
+
+
+
+
+
+  This document describes the build of Debian live images.
+
+  FIXME:
+ debian-live team: please add some useful short description here!
+ FIXME
+  
+
+
+  
+  
+  
+  ready
+  
+  
+  
+  
+  
+
+
+
diff --git a/english/doc/index.wml b/english/doc/index.wml
index c98072d6de9..dad274a9b0d 100644
--- a/english/doc/index.wml
+++ b/english/doc/index.wml
@@ -104,6 +104,7 @@ name and/or links to the online versions.
   Debian Installer internals
   Guide for database using package maintainers
   Policy for packages using databases
+  Debian Live manual
 
 
   
Title: Debian -- Debian Developers' Manuals 





  


 

  
  



  
  
   
   
  
  
Skip Quicknav

  
  Blog
  Micronews
  Planet

   
Documentation
 /
Debian Developers' Manuals
 


Debian Developers' Manuals

  Debian Policy Manual
  Debian Developer's Reference
  Guide for Debian Maintainers
  Debian New Maintainers' Guide
  Introduction to Debian packaging
  Debian Menu System
  Debian Installer internals
  dbconfig-common documentation
  dbapp-policy
  Debian Live Manual

Debian Policy Manual


  This manual describes the policy requirements for the Debian GNU/Linux
  distribution. This includes the structure and contents of the Debian
  archive, several design issues of the operating system, as well as
  technical requirements that each package must satisfy to be included
  in the distribution.


  Authors:
  Ian Jackson, Christian Schwarz, David A. Morris


  Maintainer:
  The Debian Policy group

  Status:
  ready
  
  Availability:
  Debian package
  debian-policy
  Latest version:English: [HTML] [PDF] [EPUB] [plain text]The latest 

Bug#807954: debian-live: setup automated builds of live-manual

2015-12-14 Thread Iain R. Learmonth
Package: debian-live
Severity: normal

Hi,

The old server providing live.debian.net has been shutdown. The hosted
versions of the live-manual package should now be located on the
debian-live group's Alioth webspace instead now.

This means setting up automated builds of stable/unstable (and
optionally testing/git) versions of live-manual.

The means by which this is set up should be documented on the wiki at:

  https://wiki.debian.org/DebianLive/live-manual

Thanks,
Iain.