diff --git a/projects/almanac/almanac.jpg b/projects/almanac/almanac.jpg new file mode 100755 index 0000000..9184771 Binary files /dev/null and b/projects/almanac/almanac.jpg differ diff --git a/projects/almanac/almanac.md b/projects/almanac/almanac.md new file mode 100644 index 0000000..b4fec41 --- /dev/null +++ b/projects/almanac/almanac.md @@ -0,0 +1,25 @@ +--- +categories: +- Wiki +- python +- list +cover: almanac.jpg +cover_alt: The ancient 3d book of Piet Zwart Wiki +date: 10/05/2023 +description: List of wiki pages +git: https://git.xpub.nl/kamo/almanac +slug: almanac +title: Almanac +--- + +A python script that connect to the PZI Media Wiki API, and compile a list with the title of all the pages. + +To run: + +``` +python3 almanac.py +``` + +It's going to save the list in alphabetic order into the `list.txt` file. + +[here is the list (updated at 10/05/2023)](https://git.xpub.nl/kamo/almanac/raw/branch/main/list.txt) diff --git a/projects/exex/exex.md b/projects/exex/exex.md new file mode 100644 index 0000000..843f3af --- /dev/null +++ b/projects/exex/exex.md @@ -0,0 +1,75 @@ +--- +categories: +- Python +- Tool +- Writing +cover: exex.jpg +cover_alt: uhm not yet here +date: 10/05/2023 +description: Branching and collaborative writing +git: https://git.xpub.nl/kamo/exex +slug: exex +title: EXEX +url: https://hub.xpub.nl/soupboat/exex/ +--- + +A branching version of the [exquisite corpse](https://en.wikipedia.org/wiki/Exquisite_corpse) game, forked from the [exquisite branch](https://git.xpub.nl/kamo/exquisite-branch) drawing app developed for [SI17](https://issue.xpub.nl/17/). + +Write something, upload it and send the link to someone else: they will continue from your excerpt. With a catch: if you send to just one person the chain will continue linearly, but send it to more people and things will start branching in different directions. + +Could be a writing machine to work on the collective pubblication for the graduation, inspired by what [Kim wrote here](https://pad.xpub.nl/p/gradcollectivexpub). + + +## Install + +Clone the repository. +``` +git clone https://git.xpub.nl/kamo/exex.git +``` + +Create a virtual environment. +``` +python3 -m venv venv +``` + +Install the requirements with `pip` and the `requirements.txt` file. +``` +pip install -r requirements.txt +``` + +Create an `.env` file in the root folder of the project with the following variables: +``` +DEBUG=True +FLASK_ENV=development +FLASK_APP=exquisite_branch +``` + +Before running the app for the first time, be sure to initialize the database. __Watch out:__ this will delete the previous instance of the database along with its contents! +``` +flask init-db +``` +After initializing the database you can run the flask application +``` +flask run +``` + +## Overview + +Exex saves contents in a database, and join them together in a branching version of the exquisite corpse. + +The original exquisite corpse data structure is something similar to a linked list, where every drawing is connected to the previous one. Contents in _exex_ are saved in a database with the same principle. + +![Diagram with the situationship of the entries](https://git.xpub.nl/kamo/exex/media/branch/main/linked.jpg) + +Each entry in the database has the following properties: + +- `id`: a unique identifier for every entry +- `branch`: a random name for the excerpt +- `parent`: the random name of the previous excerpt +- `content`: the actual content of the writings +- `username`: the author of the excerpt + +When generating the display page, every entry look up its `parent` property to position itself after that. + +Mhh should rewrite this better bc is super convoluted ahah. + diff --git a/projects/sail/sail.jpg b/projects/sail/sail.jpg new file mode 100644 index 0000000..ca5ab15 Binary files /dev/null and b/projects/sail/sail.jpg differ diff --git a/projects/sail/sail.md b/projects/sail/sail.md new file mode 100644 index 0000000..ba52258 --- /dev/null +++ b/projects/sail/sail.md @@ -0,0 +1,34 @@ +--- +categories: +- Web +- Animation +- Soupboat +cover: sail.jpg +cover_alt: soupboat sailing in norway +date: 05/05/2023 +description: Soupboat sailing toward new adventures +git: https://git.xpub.nl/kamo/sail +slug: sail +title: sail +url: https://hub.xpub.nl/soupboat/ +--- + +Small animation for the soupboat homepage, sailing toward new adventuress. The homepage is simple and basic, without much styling or anything. I always felt this latent feeling of reworking it, to make it different. But being a common and shared space I've never had the propper resolve to step in and transform it. To organize something altogether it was difficult because of time and life. + +Recently however, we started wondering: what will happen next? What's the future of the Soupboat? Will it stay on and working and firm on its four legs in the studio, to be rebooted from time to time by the next xpub students? Or will it follow the advenutres of the future xpub3 gang? + +We will see! In the meanwhile: let's enjoy a simple ASCII art animation of this cutie sailing away. + +## Generator??????? Finally!!! + +It was my first time using a generator! It's been a while that i wanted to try this structure, but finally found something that could make sense with it. + +A generator is something like a function with intermediate steps. Each time you call the function, it will go till the next step, preserving its internal state. + +In this particular case I used it for generating the waves pattern of the sea. + +The sea layer in the ASCII art is composed of three distinct characters: __`'~__. The script that move the soupboat towards new water keep calling the waves generator to loop through these three symbols and keep repeating the pattern. + +Look at the code for more precise documentation! + +It was fun!! diff --git a/projects/proj-monorepo/enkidu.jpg b/projects/writing-machines/enkidu.jpg similarity index 100% rename from projects/proj-monorepo/enkidu.jpg rename to projects/writing-machines/enkidu.jpg diff --git a/projects/proj-monorepo/schema_01.svg b/projects/writing-machines/schema_01.svg similarity index 100% rename from projects/proj-monorepo/schema_01.svg rename to projects/writing-machines/schema_01.svg diff --git a/projects/proj-monorepo/schema_02.svg b/projects/writing-machines/schema_02.svg similarity index 100% rename from projects/proj-monorepo/schema_02.svg rename to projects/writing-machines/schema_02.svg diff --git a/projects/proj-monorepo/proj-monorepo.md b/projects/writing-machines/writing-machines.md similarity index 95% rename from projects/proj-monorepo/proj-monorepo.md rename to projects/writing-machines/writing-machines.md index 86d398d..935231e 100644 --- a/projects/proj-monorepo/proj-monorepo.md +++ b/projects/writing-machines/writing-machines.md @@ -7,8 +7,9 @@ cover: enkidu.jpg cover_alt: My tutors are enkidu and gilgamesh date: 03/04/2023 description: Practical token to graduate -slug: proj-monorepo -title: proj monorepo +slug: writing-machines +title: Writing machines +git: https://git.xpub.nl/kamo/tag --- ## Things I'm sure about the graduation project