473,657 Members | 2,531 Online
Bytes | Software Development & Data Engineering Community
+ Post

Home Posts Topics Members FAQ

general Wiki format question and Python Wiki markup parsing libraries

hi,
i am looking for a way to structure the text in XML comments to produce
a XHTML doc format for the XMLs (in this case XSLT).
so is was thinking about using a wiki like text format. e.g. something like
<!--
!Headline

some __bold__ text in a paragraph

* a list
* another item

etc... (the markup used is only an example!)

-->

but it should be a widely used format that people do not need to learn
yet another syntax.
it will be used by people using XSLT so it should not be language (py,
perl, java, ...) specific.

is there something like a "standard" wiki format at all, or at least one
that is widely used?
in my company we use a jspwiki which e.g. uses !, !! and !!! for
headlines, __bold__ and * list markup (like the example above). is this
more or less a standard as this is the only wiki i've used yet?
i was googling for python libraries which would parse a wiki text format
to xhtml but could not find something really useful.

is there a python library to parse these text formats? i was looking a
bit into reStructuredTex t but was wondering if this is generally used or
maybe is too Python specific.

any hint would be great
thanks
chris
Jul 18 '05 #1
4 2036
chris <cs***@yahoo.co m> pisze:
is there something like a "standard" wiki format at all, or at least one
that is widely used?


Don't think so. I saw more than 10 "simplified markups", of which nearly
all was more complicated than original HTML. I wanted something like
this in my JPA, so I added possibility to use Mark Pilgrim's Python
implementation of Dean Allen's Textile (originally implemented in PHP,
Perl version also exists), but Textile is really "simplified ", its
capabilities are rather limited. Go to http://diveintomark.org/ and
check if PyTextile will suit your needs.

--
Jarek Zgoda
http://jpa.berlios.de/
Jul 18 '05 #2
Jarek Zgoda wrote:
chris <cs***@yahoo.co m> pisze:

is there something like a "standard" wiki format at all, or at least one
that is widely used?

Don't think so. I saw more than 10 "simplified markups", of which nearly
all was more complicated than original HTML. I wanted something like
this in my JPA, so I added possibility to use Mark Pilgrim's Python
implementation of Dean Allen's Textile (originally implemented in PHP,
Perl version also exists), but Textile is really "simplified ", its
capabilities are rather limited. Go to http://diveintomark.org/ and
check if PyTextile will suit your needs.


thanks for the hint. PyTextile is almost too much already and i agree
almost as "complex" as HTML. something simpler like a wiki syntax would
be much better...

chris
Jul 18 '05 #3
"Jarek Zgoda" <jz****@gazeta. usun.pl> wrote in message
news:c8******** **@nemesis.news .tpi.pl...
chris <cs***@yahoo.co m> pisze:
is there something like a "standard" wiki format at all, or at least one
that is widely used?
Don't think so. I saw more than 10 "simplified markups", of which nearly
all was more complicated than original HTML.


Well, I think the "simplified " seems to be a tradeoff in
terms of fewer keystrokes, rather than any conceptual
simplicity. If you really want to simplify things, please come
up with a little WISIWIG editor rather than yet more
line noise.

John Roth
--
Jarek Zgoda
http://jpa.berlios.de/

Jul 18 '05 #4
John Roth wrote:
"Jarek Zgoda" <jz****@gazeta. usun.pl> wrote in message
news:c8******** **@nemesis.news .tpi.pl...
chris <cs***@yahoo.co m> pisze:

is there something like a "standard" wiki format at all, or at least one
that is widely used?


Don't think so. I saw more than 10 "simplified markups", of which nearly
all was more complicated than original HTML.

Well, I think the "simplified " seems to be a tradeoff in
terms of fewer keystrokes, rather than any conceptual
simplicity. If you really want to simplify things, please come
up with a little WISIWIG editor rather than yet more
line noise.

John Roth

--
Jarek Zgoda
http://jpa.berlios.de/



well, i think it is not fewer keystrokes but to be able to easily read
the text (like here in this email without the html tag noise in e.g.
javadoc) when working on the xml/xsl file but at the same time to be
able to generate a structured xhtml documentation from the same text.
so something like restructured text seems like the best option to me for
now.

chris
Jul 18 '05 #5

This thread has been closed and replies have been disabled. Please start a new discussion.

Similar topics

14
2631
by: Viktor Rosenfeld | last post by:
Hi, I need to create a parser for a Python project, and I'd like to use process kinda like lex/yacc. I've looked at various parsing packages online, but didn't find anything useful for me: - PyLR seems promising but is for Python 1.5 - Yappy seems promising, but I couldn't get it to work. It doesn't even compile the main example in it's documentation - mxTexttools is way complicated. I'd like something that I can give a BNF
38
3602
by: Jukka K. Korpela | last post by:
As well all know, valid markup is important... but when trying to find a convincing modern argument in favor of this, I found pages like http://www.htmlhelp.com/tools/validator/reasons.html which was very nice when Netscape ruled the World Wide Web, and http://valet.htmlhelp.com/page/why.html which is very suggestive but does not really give any factual example. Is there something to be _shown_ to people who ask "why validate?"? A page...
2
1238
by: Steve Juranich | last post by:
I'm running into problems where Python and VTK both ship with their own distribution of the Expat parser. As long as you never use the Python XML package, everything is fine. But if you try using the Python XML parser after doing an `import vtk', a nice little message saying "Segmentation Fault" is your reward. For now, the workaround is to save the `import vtk' until after I do all my XML parsing. However, we're starting to build a...
2
2547
by: Tim Parkin | last post by:
I'm trying to convert fragments of wiki markup into fragments of html (specifically using moinmoin markup). I've managed to do this with MoinMoin but I've had to create a data directory, config file and underlay. Does anybody know if there a sane way of doing this without the extra baggage? Tim Parkin
0
1604
by: Yourself | last post by:
Are there any freely licensed Wiki markup to HTML converters available? Basically, I don't want to convert full wiki markup, just very basic inline formatting (specically options for bold, italic, and underline text, and creating hyperlinks) So the user would type in e.g. http://www.example.org], i'd pass that to a wiki converter function, and that would return HTML markup. I've found client side solutions written in JavaScript, but...
67
4772
by: James Harris | last post by:
I have a requirement to store timestamps in a database. Simple enough you might think but finding a suitably general format is not easy. The specifics are 1) subsecond resolution - milliseconds or, preferably, more detailed 2) not bounded by Unix timestamp 2038 limit 3) readable in Java 4) writable portably in Perl which seems to mean that 64-bit values are out 5) readable and writable in Python
0
955
by: Joshua Kugler | last post by:
Michael Mabin wrote: Several here: http://pypi.python.org/pypi?%3Aaction=search&term=wiki&submit=search I'm sure you could find a good one, and add your own markup if needed. j
0
8420
marktang
by: marktang | last post by:
ONU (Optical Network Unit) is one of the key components for providing high-speed Internet services. Its primary function is to act as an endpoint device located at the user's premises. However, people are often confused as to whether an ONU can Work As a Router. In this blog post, we’ll explore What is ONU, What Is Router, ONU & Router’s main usage, and What is the difference between ONU and Router. Let’s take a closer look ! Part I. Meaning of...
0
8324
by: Hystou | last post by:
Most computers default to English, but sometimes we require a different language, especially when relocating. Forgot to request a specific language before your computer shipped? No problem! You can effortlessly switch the default language on Windows 10 without reinstalling. I'll walk you through it. First, let's disable language synchronization. With a Microsoft account, language settings sync across devices. To prevent any complications,...
0
8842
Oralloy
by: Oralloy | last post by:
Hello folks, I am unable to find appropriate documentation on the type promotion of bit-fields when using the generalised comparison operator "<=>". The problem is that using the GNU compilers, it seems that the internal comparison operator "<=>" tries to promote arguments from unsigned to signed. This is as boiled down as I can make it. Here is my compilation command: g++-12 -std=c++20 -Wnarrowing bit_field.cpp Here is the code in...
1
8516
by: Hystou | last post by:
Overview: Windows 11 and 10 have less user interface control over operating system update behaviour than previous versions of Windows. In Windows 11 and 10, there is no way to turn off the Windows Update option using the Control Panel or Settings app; it automatically checks for updates and installs any it finds, whether you like it or not. For most users, this new feature is actually very convenient. If you want to control the update process,...
0
7353
agi2029
by: agi2029 | last post by:
Let's talk about the concept of autonomous AI software engineers and no-code agents. These AIs are designed to manage the entire lifecycle of a software development project—planning, coding, testing, and deployment—without human intervention. Imagine an AI that can take a project description, break it down, write the code, debug it, and then launch it, all on its own.... Now, this would greatly impact the work of software developers. The idea...
0
5642
by: conductexam | last post by:
I have .net C# application in which I am extracting data from word file and save it in database particularly. To store word all data as it is I am converting the whole word file firstly in HTML and then checking html paragraph one by one. At the time of converting from word file to html my equations which are in the word document file was convert into image. Globals.ThisAddIn.Application.ActiveDocument.Select();...
0
4330
by: adsilva | last post by:
A Windows Forms form does not have the event Unload, like VB6. What one acts like?
1
2743
by: 6302768590 | last post by:
Hai team i want code for transfer the data from one system to another through IP address by using C# our system has to for every 5mins then we have to update the data what the data is updated we have to send another system
2
1733
bsmnconsultancy
by: bsmnconsultancy | last post by:
In today's digital era, a well-designed website is crucial for businesses looking to succeed. Whether you're a small business owner or a large corporation in Toronto, having a strong online presence can significantly impact your brand's success. BSMN Consultancy, a leader in Website Development in Toronto offers valuable insights into creating effective websites that not only look great but also perform exceptionally well. In this comprehensive...

By using Bytes.com and it's services, you agree to our Privacy Policy and Terms of Use.

To disable or enable advertisements and analytics tracking please visit the manage ads & tracking page.