Difference between revisions of "Publisher:Beyond-Social"

From Publication Station
Line 1: Line 1:
= Beyond Social wiki skin =
= Beyond Social wiki skin =


a custom MediaWiki skin based on the Vector skin, by Manetta Berends & André Castro. README by Manetta Berends.
a custom MediaWiki skin based on the Vector skin, by Manetta Berends & André Castro.  


This wiki skin is developed for Beyond Social, a publishing project around Social Art & Design at the Willem de Kooning Academie, Rotterdam. The skin and the other wiki developments are a collaborative product of the Hybrid Publishing research group and the Social Practices department in collaboration with André Castro and Manetta Berends, and took place between November 2016 and February 2017.
This wiki skin is developed for Beyond Social, a publishing project around Social Art & Design at the Willem de Kooning Academie, Rotterdam. The skin and the other wiki developments are a collaborative product of the Hybrid Publishing research group and the Social Practices department in collaboration with André Castro and Manetta Berends, and took place between November 2016 and February 2017.

Revision as of 03:06, 27 March 2017

Beyond Social wiki skin

a custom MediaWiki skin based on the Vector skin, by Manetta Berends & André Castro.

This wiki skin is developed for Beyond Social, a publishing project around Social Art & Design at the Willem de Kooning Academie, Rotterdam. The skin and the other wiki developments are a collaborative product of the Hybrid Publishing research group and the Social Practices department in collaboration with André Castro and Manetta Berends, and took place between November 2016 and February 2017.

In between 2014 & 2016, Beyond Social already used a wiki as part of their publishing workflow, where it had a backend function for a wiki2web workflow. The wiki was a workarea, where articles and images were collected and brought together to generate the online Beyond Social Issues.

In November 2016 we made the choice to change the Beyond Social publishing workflow. The wiki2web workflow made it difficult to make relatively small changes to the structure of the Beyond Social issues, for example to the topic and section categories. The collaboration between editors and developers was sometimes difficult. The specific expectations did often not match with the wealth of possibilities that the wiki software offered. As a response to this, we decided to not use the wiki as a backend anymore, but instead, we decided to start to use the wiki as a wiki in itself: both as back- and frontend of Beyond Social.

Next to the Beyond Social skin, in which we developed custom functions for the Beyond Social wiki: a transclusion-driven Main Page, a form to create editorials, a share function to share an article on Facebook and Twitter* and we included the visual category-selection extension. These developments are part of a research to the term 'hybrid publishing'. The following sections are rapporting on the presence of hybridity while working on these wiki developments.

Hybrid publishing

The design and implementation of the Beyond Social wiki skin is commissioned by the Hybrid Publishing research group and driven by a research question around the term 'hybrid publishing'. The development of the Beyond Social skin was hybrid in the sense that it balanced between user & software: between accessibility, expectations and editorial choises & a strong, stable MediaWiki platform full of functionalities. The Beyond Social skin is a product of an aim to make working with a MediaWiki more accessible while exploring and using its built-in features in a more prominent way.

In the last few years I had become familiar with the MediaWiki software already, and to be honest, both in a visual and structural way, it was a learning curve before the wiki started to function as an interesting platform to me. Interestingly enough, as not many online platforms offer an option to not only read but also write within the same interface, this function appears to be quite non-intuitive for many users. I've seen the surpriseness on faces of students when they clicked on the 'edit' button on Wikipedia for the first time: the option to do so seems not to be obviously present. As a beginning wiki-user, it can be a bit of an adventure to navigate through the large amounts of options and special pages and find the ones that are useful for you to access the content that sometimes seems so deeply sunk into the wiki. Working with the wiki can be a learning curve, but it offers a large set of possibilities and interesting tools once this curve has been climbed. After having worked in wiki's now for a few years, i really feel that the effort of familiarizing with the wiki pays back at the moment it found its place of use.

MediaWiki software comes with many built-in features. It took quite some time browsing the software files on the server, special admin pages on the wiki and documentation on mediawiki.org before i actually started to find my way and see how and where the wiki operates. It reminded me of some social situtions and meeting new people where it normally takes me quite a bit of time to adapt to the rythm of the other, which requires a bit of extra attention but once it's there you both fall into the same pace. This moment of getting to know eachother resembled the type of collaboration i felt with the wiki in a way. It made me realise that it creates a different type of collaboration when a cms system offers you a lot of options by one-click-on-a-button, but you're not really sure how to deal with it further (something i experience while using Wordpress for example). I really appreciated it that the wiki was not automatically doing things for me, and it felt oke to take a bit of time to understand the system. Also important: when things where not so clear, there was an extensive MediaWiki documentation available.

Working with a wiki more intensively in this period of time, revealed how Mediawiki software actually is a sort of programming platform in itself. It has its own built-in language, functions and specificities, such as the automatic ip-address implementation of authors that don't have an account, markup codes such as the "~~" code that translates into a personal signature plus timestamp, and the transclusion tool that enables you to include parts of an article into another article. During the Beyond Social developments, we promoted to 'listen to the wiki' by seeing what specificities, functions and modes of collaboration it could offer to the mode of publishing within the Social Practices of the Willem de Kooning Academie.

Transclusion

This transclusion function has been very helpful for the development of the BS wiki in a practical sense. It turned out to be a useful way to work with a Main Page that we wanted to structure and style, but therefore became quite fragile and difficult to read in terms of many html elements and strict break lines. Within this fragile structure, we wanted to include a few sections on the Main Page that would need curation and therefore writing access, such as the highlighted articles, the category selection and the list of upcoming events. By transcluding single pages into

elements on the Main Page, the Main Page can be edited by not touching the Main Page itself: the curated sections are edited in a set of other (normal) pages. To do this, we used standard wiki templates. In order to transclude a short 'about' description of the Beyond Social project on the Main Page, we used this template markup

{{:About_Beyond_Social}} 

to include the page "About_Beyond_Social" into the Main Page. By default, this line trancludes the full page into the Main Page. But as we only wanted to have the first paragraph of the page, we added tags around the rest of the text. These no-inclusion tags mark which text should never be transluded into another page, and make sure that this text will still be visible when someone visits the page "About_Beyond_Social" itself. Another way to include a specific part of text is by using the <includeonly> tags. For us these tags were less useful, as these tags mark which text should be transcluded, but will make this text invisible when visiting the page itself. Visit the MediaWiki documentation pages to read more about on transclusion and templates.

A second type of transclusion that we wanted to include for the Main Page were the listings of recent user activity that are built-in wiki functions, such as recent files, new pages, wanted pages (red links) and listings of articles using the Editorial template. Some of these lists can be transcluded into other pages using standard wiki templates, such as the recent files list that can be queried like this:

{{:Special:Newimages/12}} 

For the more specific lists that we wanted to use, such as a list of all the pages that use the Template:Editorial for example, we needed a few more transclusion options . MediaWiki software comes with many functions, but there is also a large amount of plugins available, called extensions, of which some are more stable then other. (See this page listing all available extensions in the MediaWiki database.) We decided to use an external plugin called DynamicPageList (DPL) that offers specific transclusion options to create lists of a specific category or query the last batch of activity from a special page such as all the pages that use the Template:Editorial. A DPL transclusion to do this looks like this:

<DPL>

  uses=Template:Editorial

  ordermethod=firstedit

  order=descending

  count=10

</DPL> 

Editorials

Beside a custom Main Page, we developed a special type of article page for the Beyond Social wiki: editorials. An editorial is a type of article that anyone can create. It is a page where a list of various articles can be collected, and accompanied with a short introduction and image. Editorials can be used for example to highlight a specific theme that appears in Beyond Social, or to bring a set of student projects together that have been created in the same year. These are example, the author of an editorial is free to curate article together according to his own interests.

Editorials are created through a form, for which we used the Semantic MediaWiki page forms. (See this test editorial for an example). Thanks to the form and its predefined structure, it is easier to create an editorial. The form includes input fields with an autofill function, which makes it easier to search for specific articles and image files on the wiki. The form is connected to a template by including this syntax:

Editorial

The template displays every editorial in the same layout, which makes them easily recognizable as being a special type of page. At the moment that a form is published, the wiki creates an article page and writes the content of the form into the structure of the template.

To create the list of article selections, we needed an option which would let the author free in deciding how many article he/she wanted to include in his/her editorial. To add a # number of articles, we looked for a way in which a single part of a form can be repeated for a # of times. As we only wanted this smaller part of the form to be repeated, we created a seperate Article Selection template:

Article Selection

The 'multiple' option in this line enables an add button in the interface of the form, together with a drag-and-drop function to change the order and a delete button to remove items from the list. At the moment that a form is published, the content of the list is placed in the Template:Article Selection. In the template, the wiki receives the list with the '#arraymap' function, which is a function that work with a list of items and repeats the Article Selection template as many times as there are items in the list:

{{#arraymap:|,|x|x}}

For more detailed information, there is a longer explanation here on the MediaWiki site.

After publishing an editorial, the page can be edited through the form again. To do this, Semantic MediaWiki offers the option to add an "Edit with form" option to the action menu, see for example here. For more info see this MediaWiki documentation page.

Install the BeyondSocial skin and customize your own

The Beyond Social skin is based on the Vector skin and is implemented in a Mediawiki 1.28 installation. Make sure you install this version or higher. It is recommended to make an installation of MediaWiki locally, where you can test your changes to the skin.

Install MediaWiki in the /var/www/html/ of your server or computer by following the MediaWiki installation guide into a folder called "wiki" for example.

Download or clone the BeyondSocial-wiki git repository in the /var/www/html/ of your server or computer.

cd /var/www/html/

git clone https://github.com/wdka-publicationSt/BeyondSocial-wiki.git

It will create a folder called BeyondSocial-wiki that contains one folder called "skins" in which the BeyondSocial skin is located. If you want to rename the skin to make it your own, there is a useful command line tool called "rename", to rename all the BeyondSocial / beyondsocial / Beyond Social mentions to your own name.

Copy all the files of your MediaWiki installation from the folder "wiki" to the folder "BeyondSocial-wiki" EXCEPT the "skins" folder.

cd /var/www/html/wiki/

cp -r !(skins) ../BeyondSocial-wiki

You can copy the deafult wiki skins if you want to have these available too.

 cp -r skins/Vector ../BeyondSocial-wiki/skins/

 cp -r skins/Monobook ../BeyondSocial-wiki/skins/

 cp -r skins/Modern ../BeyondSocial-wiki/skins/

 cp -r skins/CologneBlue ../BeyondSocial-wiki/skins/

Remove the "wiki" folder, and rename the BeyondSocial-wiki folder to "wiki".

cd /var/www/html/

rm -r wiki

mv BeyondSocial-wiki wiki

To make the BeyondSocial skin your default skin, edit the settings in the LocalSettings.php file that is located in the main "wiki" folder.

cd /var/www/html/wiki/

nano LocalSettings.php

Firstly, the skin need to be loaded by MediaWiki. Enable the Beyond Social skin by adding this line (with the Uppercases in place!):

wfLoadSkin( 'BeyondSocial' );

Edit the line that sets the default skin to the following (all lowercase!):

$wgDefaultSkin = "beyondsocial";

Exit nano with CTRL+X, and type a Y to save the changes. Now go to your MediaWiki installation through the browser and see if it worked!

localhost/wiki (for local installations)

example.com/wiki/ (for server installations)

Editing the skin

skin.json: This file is the settings file for the Beyond Social skin. Here, you can add media queries to make the wiki respond to different screen sizes and include a stylesheet for printing. See line 33, "ResourceModules".

css: All the css files of the skin are included in the /skin/BeyondSocial/components/ folder. Another option could have been to use the common.css page on the wiki, but due to the amount of css we needed to add, we decided to store it in the skin folder itself. The skin works with .less in stead of .css files. We continued to work with less as the Vector skin was based on these files. There is a .less file for different sections of the wiki: for example there is a footer.less, navigation.less and personalMenu.less. These .less files originated from the Vector skin, but are edited according to match our wishes. The files bs-editorials.less, bs-mainpage.less and bs-namespaces.less are added for Beyond Social. Less enabled us to work with variables in css, something new for me but very useful. There is a variables.less file in the main /BeyondSocial/ folder in which all the main variables are stored that are called in the other .less files.

php: BeyondSocialTemplate.php is the most important php file. Some elements have been moved around here, and a few lines of html have been added, but we tried to add as less as possible. The lines that are changed are marked with comments.

js: beyondsocial.js is where you can add javascript functions. The only javascript that is added to the skin is called by the Share option in the menu. It selects the first image of a page, and include that as a header in the html. Facebook's sharing function reads this image and places it next to the link you want to share.

plugins

To make the use of the wiki more accessible, we installed a few plugins, such as the Page Form plugin for the Editorials, and the Category Selector. The latter one is used for the small category-selection interface that appears under a text input field to make it easy to categorize your article. We tried to install a visual text-editor as well, but without success unfortunately. See the Special:Version page for the plugins that are currently installed.

license

This skin is licenced under a free software GNU GPL v3 license.

Because the BS wiki is part of the education of the Willem de Kooning Acedemy we can not open the BS wiki skin up for any contributions. However, we are happy to share our work with you and allow anyone to clone this repository, and use it to create your own custom wiki skin.

links