_Syntax

<Cesar Harada> Open Architecture is written in AcademiXML, a custom markup format developed to enable multiple authors to contribute on the same document without loosing authorship. 
In academia, documents without specified author (like Wikipedia articles) cannot be cited since tracing the author (responsible) is unclear. You CAN cite openarchitecture.cc, you know who is the author, you can contribute (request permission).
You don't need to be a coder to understand and use AcademiXML - it is super super super simple, just relax and read below. 

Being able to have a document with different "voices" has many advantages : 
- it is lively like a conversation, similar to theater.
- contradictory opinions can be expressed in the same paragraph by different people.
- a sentence can be started by someone (1), interrupted by someone else (2), ended by somebody else (many more).
- not having a "discussion page" or "hidden comments" : everything is on the same document (similar to google wave in many ways)
- the content of the website becomes easier to search/index by search engines. 
- we can automate computer extraction of one specific author declarations.
- we avoid anonymous trolls :)

We can formulate together complex ideas while remaining simple and readable on a single level. 
AcademiXML 1.0 is inspired from HTML / XML and LateX, but it is MUCH simpler markup.

Rules : 
The Section "Contributors and syntax" specifies the real names (preferred) of the authors, dates of contributions, and author marker as <FirstName Name>.
We like the authors to share an email at which they can be reached if we have questions from visitors/ contributors/ admin/ publishers.
For those who refuse to use AcademiXML but still want to contribute, you can comment at the bottom of each page. Thanks.

Solo : 
<FirstName Name> the declaration </FirstName Name>

Duo :
<Natalie Jeremijenko>She starts her declaration, </Natalie Jeremijenko> <Angel Borrego Cubero>he inserts one thought in there and </Angel Borrego Cubero> <Natalie Jeremijenko> she finally concluded what she was saying. That works.</Natalie Jeremijenko

Multiple
<Jerry>It would be great</Jerry><Tom>if bricks were made of </Tom><Agatha> white chocolate.</Agatha>

--
Common mistake : BAD ! Don't do that. 

Mistake in insertion :
<Jerry>It would be great <Tom> bricks were made of </Tom> white chocolate.</Jerry>
This is wrong :( Impolite. 
Don't put declaration inside someone else's declaration. Close the previous declaration, open yours, close yours, re-open the other's person's declaration : 
<Jerry>It would be great </Jerry><Tom> bricks were made of </Tom><Jerry>white chocolate.</Jerry>
This is right :) Polite, one after the other, listening to each other, a discussion. 

Inconsistent markup
<•ƒL∑x>Hello, I'm the greatest hacker on earth </FLex>
This is not good, because the marker at the beginning is different from the marker at the end, so it won't be properly indexed / parsed if the document is analyzed for specific author automated extraction. Ideally the real name is the <name> - again, for authenticity and academic value. 


If you have any questions, please feel free to contact me <contact [at] cesarharada [dot] dom>. 
Of course AcademiXML1.0 is Public Domain, so feel free to use, modify, fork, distribute, format your academic papers in this format. 
The fist AcademiXML1.0 document that has been officially been accepted in academia is "20090315open_architecture" available at the Royal College of Art, London, written under the kind supervision of Prof. Sarah Teasley, Critical History Tutor. Hiromi Ozaki (aka Sputniko) also wrote her RCA MA dissertation in AcademiXML2.0 also kept at the RCA central librairy . </Cesar Harada>
Comments