This guide will help you document your work. The main purpose of this documentation is not only to present your progress, but also to expose your methodologies and working methods to potential readers.
Upon completion of your project, your documentation should include the following:
- Initial concepts or ideas
- The culmination or the “arriving point” of your work
- Explanation of ideas, thoughts, and technologies used in your project
- Your reflections on the project’s process and outcome
- Your perspective on using speculation as a method of artistic research
For these sections, you are not limited to strictly textual content. You are free to incorporate and mix various media such as images, audio, video, drawings, graphics, formulae, and code examples.
Organize your project documentation in a manner that best suits your work. You might decide to update it regularly as a blog or a diary, or perhaps you’d prefer to document everything after the project’s completion. We’re most interested in documenting the journey, including unfinished thoughts, abandoned paths, and preliminary sketches. Feel free to create any number of subpages as your project evolves.
The main objective here is to make your artistic research and working process visible rather than focusing solely on the final result.
If you need assistance or wish to expand upon the features of this portal, feel free to reach out to us!
Some useful information on the documentation #
This page is a copy of the Speculative Sound Synthesis webpage. It aims to help guest artists document their artistic research within their respective projects. Any updates made on this page are not public. Once the research documentation is complete, the respective pages will be transferred to the public project webpage.
Setting up #
The page has been shared to you via nextcloud. Please install the nextcloud client and update the folder with your materials in the client. This will help us keep up to date and help you with your process.
The webpage uses the Hugo framework. Hugo is a static site generator that generates pages from markdown files. To get started, you have to install hugo. To preview your pages, in your terminal, go to the folder of the webpage and type hugo server. You will then be able to see the page locally in your browser.
Media #
Please upload all media (images, video, sound) in the “static” folder of the webpage and reduce file size when possible.
Format #
This platform supports text, images, video, sound, and code, etc. Hugo’s shortcodes should provide any desired formatting functionality.
Image example #
Video example #
Sound example #
Javascript #
You can add JavaScript to a Hugo markdown page by including a
<script> tag in the markdown source. Note that the script can be
included anywhere in the body of the markdown document.
<script>
document.addEventListener('DOMContentLoaded', (event) => {
console.log('This is a demo JavaScript code');
});
</script>
If you’re including an external JavaScript file, you would use the src attribute like so:
<script src="https://example.com/js/script.js"></script>
Code example #
You can use SuperCollider language syntax highlighting using Hugo and Markdown. Here is an example of how to use it:
x = {
var in = SinOsc.ar(200);
var out = AutoRegNNFilter.ar(in, 1, 12, 8, 1, 0.1, 0.0001);
[in, out]
}.play;
Or, using the highlight.js
(
x = {
var in = SinOsc.ar(200);
var out = AutoRegNNFilter.ar(in, 1, 12, 8, 1, 0.1, 0.0001);
[in, out]
}.play;
)
Please ensure all code developed and used in your project is accessible and available to whoever will view your work (e.g. a public git repository).
Research Documentation Examples #
The following links provide examples of documetation of artistic research projects that can serve as inspiration. Please note however that style, format and content of these examples are highly specific to the respective projects and we really encourage you to think specifically about the needs of your project.
Luc Döbereiner and David Pirrò: Contingency and Synchronization
https://www.researchcatalogue.net/view/1825188/1825189
Ji Youn Kang: Sound Spatialization in Live Electronic Music
https://www.researchcatalogue.net/view/1441817/1464267
ECHO Issue 2_21.07.09: Networks