doc:wrap

Differences

This shows you the differences between two versions of the page.

Link to this comparison view

Both sides previous revision Previous revision
Next revision
Previous revision
doc:wrap [2026/03/31 13:36] – [Used on the site already] Simon Grantdoc:wrap [2026/04/05 08:55] (current) Simon Grant
Line 4: Line 4:
  
 //Try out all these techniques below in the [[playground:playground]].// //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 ===== ===== Using the toolbar =====
Line 13: Line 18:
  
 You probably won't need to use any of these, but you are welcome to explore, or ask for help if desired. 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 ===== ===== 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 in every page; this is just the first one that comes to hand.+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. 
  
  
  • doc/wrap.1774964217.txt.gz
  • Last modified: 2026/03/31 13:36
  • by Simon Grant