--- title: "How this blog is made, Archivarix, some PHP and Hugo" date: 2022-12-03T17:17:00+01:00 toc: true tags: ["this blog", "Archivarix", "PHP", "gohugo"] --- ## The legacy of my blog, recover with Archivarix For me this year was like a rollercoaster, and I forget my blog was hosted on a very old Online.net Dedibox server, now called Scaleway. This server was in a process to be decomission and I missed the 3 emails annoncing the end of my services. Then Online.net decided that it was a good idea to also delete the backups spaces attached to these machines. To sumup I loose my blog and the recent backups. But I wanted to keep it and a least serve the existing content that was linked on search engines and other websites. I looked on the wayback machine and my blog was in it. I found a cool all-in-one service to restore an entire website from the Wayback machine called Archivarix, the cost was arround 10€. I recovered a 300MB zip archive with a lot of content, some images are missing but all the articles was there. ## Running the Archivarix Loader Archivarix loader is a single php file using a sqlite database with all your urls inside and the content is stored as files in `www/.content.EZtzwPjb/binary/`. Each time a HTTP request is process, the script look in the database for a matching url and serve the content linked to it. This mini cms is license under GPL, and I put a copy [here](https://home.hugopoi.net/gitea/hugopoi/blog.hugopoi.net/src/branch/master/www/index.php). ### With docker You need PHP and SQLite extension, the PHP docker image already contains that. I have done a small docker-compose for running archivarix. Simple as run `docker compose up`. * [docker-compose.yml](https://home.hugopoi.net/gitea/hugopoi/blog.hugopoi.net/src/branch/master/docker-compose.yml) 

* [nginx.conf](https://home.hugopoi.net/gitea/hugopoi/blog.hugopoi.net/src/branch/master/nginx.conf)
  


 {{< figureCupper
img="Screenshot 2022-11-20 at 18-54-58 HugoPoi – Internet Hardware et Bidouille.png"
caption="First run of my old website"
command="Fill"
options="1024x500 Top" >}}


### With Yunohost

I'm mainly self-hosted with the Yunohost project, those next steps show
you how to easily add a small php inside your Yunohost instance.

1. Install the application `My Webapp` inside the yunohost admin panel

    {{< figureCupper
    img="Screenshot from 2022-11-21 18-40-13.png"
    caption="TODO"
    command="Fit"
    options="1024x500" >}}

1. Fill the setup form

    {{< figureCupper
    img="Screenshot 2022-11-21 at 18-41-13 Install my_webapp _ Catalog YunoHost Admin.png"
    caption="TODO"
    command="Fill"
    options="1024x500" >}}

1. You have an empty app inside `/var/www/my_webapp/www/`

    {{< figureCupper
    img="Screenshot from 2022-11-21 18-42-30.png"
    caption="TODO"
    command="Fit"
    options="1024x500" >}}

1. You need to copy your files, I use rsync with the yunohost admin account

    `rsync -rlgoD --checksum --verbose www/ admin@home.hugopoi.net:/var/www/my_webapp/www/`

1. Then you might need to `chmod 664 /var/www/my_webapp/www/.content.*/structure.*`, Archivarix required some write access on the sqlite files.


## Modding Archivarix Loader

### Fixing Wordpress version missing files

The homepage was looking good but some wordpress css and javascript assets were missing. Wordpress use a query params `?ver=`.

 {{< figureCupper
img="Screenshot 2022-11-20 at 18-55-57 Linky opendata my ass – HugoPoi.png"
caption="First run of my old website, some broken css looking wrong"
command="Fill"
options="1024x500 Top" >}}

{{< figureCupper
img="Screenshot-Firefix-debugger-404-ver-wordpress-archivarix.png"
caption="Missing files because of the Wordpress `?ver=` query params with Archivarix"
command="Fit"
options="1024x500" >}}

So I code a little function to load any version available for a
given url. And I take the most recent one.

* [`getOtherWordpressVersionUrls` function in www/index.php](https://home.hugopoi.net/gitea/hugopoi/blog.hugopoi.net/src/commit/2a154a6eea510e08b2608fd55f6729056c363b25/www/index.php#L295-L305)
  


* [The call in www/index.php](https://home.hugopoi.net/gitea/hugopoi/blog.hugopoi.net/src/commit/2a154a6eea510e08b2608fd55f6729056c363b25/www/index.php#L609-L614)
  



### Cleaning existing pages

After successfully running my backuped blog, I wanted to mod some
content.

* Replace the twitter widget
* Replace the hoster widget
* Add a legacy warning for visitor to redirect to the new blog

Archivarix has a `ARCHIVARIX_INCLUDE_CUSTOM` relying
on regular expression to replace content but I needed a more precise approach. I used the PHP XML extension which has a DOM parser buit in and can
parse HTML pages.

* [The easy config to add/replace/delete some html parts](https://home.hugopoi.net/gitea/hugopoi/blog.hugopoi.net/src/commit/cd94d82c1a3dad22b026c9c26311b366f76dcd54/www/index.php#L97-L133)
  

* [The clever mod](https://home.hugopoi.net/gitea/hugopoi/blog.hugopoi.net/commit/598d28551d071774007172782541e1d140b8a3c1#diff-eb630ac88267e24589fd94de0826721dff38beb4)
  


## The new blog with Hugo

I wanted simple markdown that generate static HTML, this why I choose Hugo for my blog.
1. First I add a new directory called `v2` next to the legacy blog. 
1. Then you launch `hugo new site v2` this will generate the folder tree needed.
1. I choose the Cupper theme

    {{< figureCupper
    img="Screenshot 2022-12-03 at 15-30-20 Cupper.png"
    caption="Cupper Theme for Hugo"
    command="Fit"
    options="1024x500" >}}

1. I add the Cupper theme with `git submodule add https://github.com/zwbetz-gh/cupper-hugo-theme.git themes/cupper-hugo-theme`
1. Add some [custom css](https://home.hugopoi.net/gitea/hugopoi/blog.hugopoi.net/src/commit/80eed4ba721287f4854f26e62a094b26997b4b69/v2/static/css/cupper-hugo-tweaks.css)
    

1. Add some config in [`config.toml`](https://home.hugopoi.net/gitea/hugopoi/blog.hugopoi.net/src/branch/master/v2/config.toml)
    


1. I also upgrade prism.js for code highlight in theme itself
1. I add favicon and logo
1. Then I need to build with `hugo`
1. Deploy with rsync in yunohost
    

1. I add a CORS header in nginx config
   of my Gitea to allow fetching code inside `
` html tags
     ```nginx
     rewrite ^/gitea$ /gitea/ permanent;
     location /gitea/ {
         proxy_pass                  http://localhost:6000/;
         proxy_set_header            Host $host;
         proxy_buffering off;
         client_max_body_size        200M;
         proxy_set_header X-Real-IP $remote_addr;

         # Include SSOWAT user panel.
         include conf.d/yunohost_panel.conf.inc;

         add_header 'Vary' 'Origin';

         # Add CORS header for loading code in pre html tags
         if ($http_origin ~* "^(http://localhost:1313|https://blog.hugopoi.net)$") {
             add_header Access-Control-Allow-Origin "$http_origin";
         }
     }

     ```

Moooore to come !