doc:wrap [Knowledge Commons]

This page is read only. You can view the source, but not change it. Ask your administrator if you think this is wrong.
//part of the [[start|GtC documentation]]//

====== WRAP ======

//Try out all these techniques below in the [[playground:playground]].//

What WRAP does is essentially sneaking in some HTML functionality (and as you might also see, following HTML syntax) for a few things that aren't easy in a [[wp>lightweight markup language]] (LML). This kind of thing is a common feature of wikis and related systems. HTML is, for sure, more complex and less straightforward than a LML, but much much richer in what it can do. So many wiki systems allow embedding of HTML in one way or another. 

It's part of the same challenge that people have been struggling with for decades. How do you give people control over what's in a document and how it appears, without making it too difficult to write, edit, or code? Some people these days say AI is the way to go — personally I'm not so sure; I prefer the idea of people supporting each other to learn the skills they need, in a learning commons ^_^


===== Using the toolbar =====

Near the right end of the toolbar, there is a button icon: {{wrap-icon.png|This is an illustration: don't click here!}}.
Clicking here reveals a long menu: 

{{wrap-menu.png|This is an illustration: don't click here!}}

You probably won't need to use any of these, but you are welcome to explore, or ask for help if desired.


===== Used on the site already =====

Just taking a couple of examples from the first topic [[comg:commoning]] in the first topic group [[gt:community]] & culture, there are several uses of the `<WRAP>` feature. We've used it on just about every page; this is simply the first one that comes to hand. 

```
<WRAP center centeralign> 
<figure>
{{url>https://www.youtube.com/embed/7bQiBcd7mBc 560,315}}
<caption>
_How does the commons work? From the [Next System Project](https://thenextsystem.org/)._
</caption>
</figure>
</WRAP>
```
gives

<WRAP center centeralign> 
<figure>
{{url>https://www.youtube.com/embed/7bQiBcd7mBc 560,315}}
<caption>
_How does the commons work? From the [Next System Project](https://thenextsystem.org/)._
</caption>
</figure>
</WRAP>

The above illustrates centering and captions, as well as an embedded video. 

It's essentially the same with still images, as reproduced below.
Here we have used Markdown syntax. 

```
<WRAP center centeralign>
<figure>
![Indigenous people](https://lowimpactorg.onyx-sites.io/wp-content/uploads/survival-international.jpg)
<caption>
_[Survival International](https://www.survivalinternational.org/) are fighting the enclosure of ‘wilderness’ that has been commoned by indigenous people all over the world for millennia._
</caption>
</figure>
</WRAP>
```
gives

<WRAP center centeralign>
<figure>
![Indigenous people](https://lowimpactorg.onyx-sites.io/wp-content/uploads/survival-international.jpg)
<caption>
_[Survival International](https://www.survivalinternational.org/) are fighting the enclosure of ‘wilderness’ that has been commoned by indigenous people all over the world for millennia._
</caption>
</figure>
</WRAP>

----

There are many many more examples on almost every topic page. You get the general idea — you can always look at the lightweight markup language on any page that you have permission to edit.

===== See also =====

See the documentation on [[doku>plugin:wrap]] on the DokuWiki site.