-1. Go to https://gitlab.torproject.org/tpo/web/manual/-/jobs/

-2. Open the latest build stage

-3. Download the artifacts (they come in a .zip file).

-4. Rename it to manual_$PIPELINEID.zip

-5. Upload it to people.tpo

-6. Update projects/manual/config

-   6.1 Change the version to $PIPELINEID

-   6.2 Update the hash in the input_files section

-   6.3 Update the URL if it was different from the previous uploader

-    find chrome/ | sort | zip -X -@ "$tbdir[% IF c('var/macos') %]/Contents/Resources[% END %]/browser/omni.ja"

-However, the CI artifacts include a lot of files used by other Tor sites but not

-from the manual, so we delete them in our build script to save space in the

-builds. Also, the paths to resources need to be updated, because we serve the

-manual as an about page, so we need to convert them to full `chrome://` URIs.

-mkdir -p chrome/browser/content/browser/manual

-unzip $rootdir/[% c('input_files_by_name/manual') %]

-python3 $rootdir/[% c('input_files_by_name/package_script') %] public chrome/browser/content/browser/manual

-pushd chrome/browser/content/browser/manual/static

-find -name '*.map' -delete

-rm -rf fonts

-rm -rf css/digital-climate-strike css/images

-# We prune unused images in the Python script, but empty directories remain

-find images -type d -empty -delete

-popd

-    tar_src => [ 'chrome' ],

-version: 321660

-  - URL: 'https://build-sources.tbb.torproject.org/manual_[% c("version") %].zip'

-    sha256sum: 9adb7d8ca2c9cb7dbd8d13d46135ea9f42636eafd053192fc5e233f2426cd8a3

-  - filename: packagemanual.py

-#!/usr/bin/env python3

-from pathlib import Path

-import re

-import sys

-import shutil

-

-

-PAGE_NAME = 'offline-docs'

-STATIC_PATH = 'chrome://browser/content/manual/static'

-

-if len(sys.argv) < 3:

-    print(f'Usage: {sys.argv[0]} lektor-out-directory target-directory')

-    sys.exit(1)

-

-source = Path(sys.argv[1])

-target = Path(sys.argv[2])

-if not target.exists():

-    target.mkdir(exist_ok=True)

-

-static_re = re.compile('"(?:../)*static/([^"]+)"')

-link_re = re.compile('href="../([^"]+)"')

-

-

-def clean_urls(match):

-    m = re.match(r'(?:../)?([^/#]+)[/]?[#]?(.*)', match.group(1))

-    slug = m.group(1)

-    if m.group(2):

-        anchor = '_' + m.group(2)

-    else:

-        anchor = ''

-    return f'href="#{slug}{anchor}"'

-

-

-remove_images = []

-for p in (source / 'static/images').glob('**/*'):

-    if p.is_file():

-        rel = p.relative_to(source)

-        remove_images.append(rel)

-

-htmls = source.rglob(f'{PAGE_NAME}/index.html')

-for page in htmls:

-    with page.open(encoding='utf8') as f:

-        contents = f.read()

-

-    remove_images = list(filter(

-        lambda im: contents.find(str(im)) == -1, remove_images))

-

-    contents = static_re.sub(f'"{STATIC_PATH}/\\1"', contents)

-    contents = link_re.sub(clean_urls, contents)

-

-    rel = page.relative_to(source)

-    dest_name = str(list(rel.parents)[-2].name)

-    if dest_name == PAGE_NAME:

-        dest_name = 'en'

-    dest_name += '.html'

-    with (target / dest_name).open('w', encoding='utf8') as f:

-        f.write(contents)

-

-

-def ignore_images(path, names):

-    return [

-        n

-        for n in names

-        if Path(path, n).relative_to(source) in remove_images

-    ]

-

-

-shutil.rmtree(target / 'static', ignore_errors=True)

-shutil.copytree(source / 'static', target / 'static', ignore=ignore_images)

-PROJECT_ID = 23

-    manual_fname = f"manual_{pipeline_id}.zip"