This Guidebook is the collected wisdom of the W3C Group Chairs and other collaborators.
It happens occasionally that you have been happily taking minutes in IRC and at the end of the meeting discover (oh horror!) that nobody invited RRSAgent! No logs, no minutes… What now?
RRSAgent does three things: keep a log of what is typed in IRC, call a program to turn the log into nice minutes in HTML, and upload the minutes. So, without RRSAgent, you will need to do those three things yourself. How? It depends on your skills, environment and preferences.
First you need the text that was typed into IRC.
If you can scroll back up in your IRC window, you may be able to find the start of the minutes and copy-paste all text into an editor window or into the online minutes tool (see the next section).
If you were using an IRC program on your own computer (rather than the web interface), it may have kept logs in a file, if you previously configured it to do so. If you can find that log file, you can copy the minutes from there.
And if that doesn't work, maybe somebody else who was in the meeting still has the logs.
RRSAgent uses a program called scribe.perl to process the text. You can process it yourself in one of two ways: using an online service or by running scribe.perl locally.
To use the online service, go to the Online Minutes Generator. You can copy-paste your text into the text box, or, if you have the text in a file, upload the file. The web service will try to run scribe.perl to turn the text into minutes in HTML and display them. If it succeeds, you can save the page and proceed to task 3. Otherwise some editing may help, see ‘editing the log’ below.
To run scribe.perl locally, you need to download it. You also need to have Perl installed and you need to have access to a command line. Save the text of the minutes into a file (e.g., into ‘log.txt’) and type something like:
perl scribe.perl log.txt > minutes.html
There are various options you can add, e.g., to select the style or to embed scribe.perl's diagnostic messages in the minutes.
Try to open the result, ‘minutes.html’, in a browser to see if the command succeeded. If so, you can proceed to task 3.
✏ Editing the log: If the above didn't produce correct minutes, it may be that scribe.perl didn't recognize the format. The section Input Formats in the manual shows examples of IRC logs that scribe.perl knows. Maybe by editing your log in a text editor you can make it look sufficiently like one of the recognized formats.
Once you have the minutes, you can send them to a mailing list. If the mailing list is archived, that gives them a URL as well. But it is also good to have them stored in the usual place for minutes under https://www.w3.org/2021/03/ or whatever the current year and month is.
Uploading requires special privileges. Typically, it needs to be done by a team member.
First determine what the URL of the minutes is going to be. The conventional URL is of this form:
https://www.w3.org/YYYY/MM/DD-xxx-minutes.html
Here YYYY, MM and DD represent the year, the month and the day of the meeting and xxx is the name of the IRC channel on which the meeting took place. Some examples:
Then there are several ways to upload a file.
You can use BlueGriffon. Load the minutes into BlueGriffon and use the PUTter command from the Tools menu. BlueGriffon will ask you for the URL and then for your username and password. (There are also some other editors that know how to do HTTP PUT, such as Kate.)
If you have the curl program, you can use it from a command line. Assuming you put the formatted minutes in minutes.html, the command is:
curl --location-trusted -u myusername -T minutes.html https://www.w3.org/YYYY/MM/DD-xxx-minutes.html
Where myusername is your username. Curl will prompt for your password.
(The --location-trusted option tells curl to follow
redirects. In fact, the www.w3.org server doesn't handle the
upload itself, but redirects to edit.w3.org. That means you
could also use this shorter command: curl
-u myusername -T minutes.html
https://edit.w3.org/YYYY/MM/DD-xxx-minutes.html
)
A third way is to use CVS to upload the minutes.
Assuming you have already checked out some part of the W3C web
site somewhere, first make sure you have the
WWW/YYYY/MM directory checked out, e.g.,
like this: go to the WWW directory (the root of the checked out
site) and do this on the command
line: mkdir YYYY; cvs add YYYY;
cd YYYY; mkdir MM; cvs add MM;
cd MM
(Replace YYYY
and MM with the year and month, as above.) If one or
both of the YYYY and MM directories are
already checked out, this will give some error messages, but in
any case this puts you in the MM directory. (You can
of course also use a graphical CVS client.)
Copy the formatted minutes to this directory and name the file
DD-xxx-minutes.html. Then check it in with
cvs commit
DD-xxx-minutes.html
from the
command line (or the equivalent in your graphical client).
A fourth way is to use WebDav. If your
operating system supports the WebDav protocol, or you have a
WebDav program, you can connect to edit.w3.org and use it almost
as if it were a directory on your local system. Under Debian and
similar Linux distributions, you need the davfs package and then
you can mount the file system (as root) with something like
mount -t davfs https://edit.w3.org /mnt
. After
that, you can find the contents of edit.w3.org under /mnt
and
you can create the file
/mnt/YYYY/MM/DD-xxx-minutes.html
for your minutes. When using KDE, you don't even need to mount
the file system, just type ‘webdavs://edit.w3.org’ in the
location bar in Dolphin or Konqueror, navigate to the right
directory and copy your minutes there. Under MacOS, you can use
‘Go’ → ‘Connect to server’ in the Finder and enter
‘https://edit.w3.org’ in the dialog in order to mount
edit.w3.org as a file system. If you use Emacs, you also don't
need to mount the file system (assuming the tramp package is
loaded, which it usually is): You open edit.w3.org as a
directory by opening ‘/davs:myusername@edit.w3.org:/
after which you can navigate to the right directory and create
the minutes file there.
Note: If WebDav doesn't show you a directory, or the directory appears empty, although you know that it isn't, the problem is usually that the directory has no access defined. Use the ,access tool to set the directory to Team-only (or some other access, as appropriate).