0

I am looking for a markup language for human, to describe a group of physical objects and their characteristics (size, position, type…). I know about YAML but I would like to know if anything else exists. It must be simple, readable and editable for non skilled users.

XML-like markup language are too complicated: users must be able to edit directly a description of physical objects such as:

Objects
    object1
        x position: 5cm
        y position: 10cm
        height: 20cm
        width: 30cm
        height: 20cm
        …

I am not even sure if that kind of user will know what an indent is. Of course I can tell them how to edit in a documentation file but I must be as close to human writing as possible.

5
  • 2
    Was YAML really the only thing that came up in your research?
    – Marcin
    Apr 2, 2012 at 12:54
  • 2
    This is a very open ended question, but many other markups exist and how readable they are tends to be how well they are written, for example XML is a good choice here if your schema designed well they can be easily human readable, I take it you have rejected xml, or it somehow doesn't suit your needs Personally i started using YAML last year for things that humans needed to read easily and so far I have no complaints from anyone Apr 2, 2012 at 12:55
  • @Marcin For my purpose yes, do you have anything else in mind?
    – 1213
    Apr 2, 2012 at 13:33
  • rooofl No, not least because I have no idea what your purpose is. This sounds like an application where XML could be perfect, but as @krystanhonour does, I assume you have already rejected that for some reason which you have chosen not to reveal.
    – Marcin
    Apr 2, 2012 at 13:45
  • @Marcin you are right, I edited my request trying to be more precise.
    – 1213
    Apr 2, 2012 at 14:27

2 Answers 2

2

Is there any reason the users need to edit the markup directly could you not write a simple application that they enter data into a form or via a number of checkboxes etc and alter it yourself programatically not entirely sure why non skilled user would be editing a file of this nature surely a user of this nature would prefer a nice application

1
  • It is part of an art project where raw documentation is fundamental.
    – 1213
    Apr 4, 2012 at 13:28
1

I disagree that xml is too complicated. It is excellent for key-value representations where you know the keys ahead of time:

<object name="Object1"
        x-position="5cm" />

You will probably have to mess around with DTDs to get your xml processor to treat the tag as self-closing.

Your Answer

By clicking “Post Your Answer”, you agree to our terms of service and acknowledge you have read our privacy policy.

Not the answer you're looking for? Browse other questions tagged or ask your own question.