Skip to main content
  • Log in
  • Manage Cookies
Eclipse Foundation
Download
  • Projects
  • Working Groups
  • Members
  • Community
    • Marketplace
    • Events
    • Planet Eclipse
    • Newsletter
    • Videos
    • Blogs
  • Participate
    • Report a Bug
    • Forums
    • Mailing Lists
    • Wiki
    • IRC
    • Research
  • Eclipse IDE
    • Download
    • Learn More
    • Documentation
    • Getting Started / Support
    • How to Contribute
    • IDE and Tools
    • Newcomer Forum
  • More
      • Community

      • Marketplace
      • Events
      • Planet Eclipse
      • Newsletter
      • Videos
      • Blogs
      • Participate

      • Report a Bug
      • Forums
      • Mailing Lists
      • Wiki
      • IRC
      • Research
      • Eclipse IDE

      • Download
      • Learn More
      • Documentation
      • Getting Started / Support
      • How to Contribute
      • IDE and Tools
      • Newcomer Forum
  1. Home
  2. Blogs
  3. Wayne Beaton's blog
  4. Authoring in Eclipse

Authoring in Eclipse

Tuesday, January 17, 2006 - 10:07 by Wayne Beaton

Apologies to Chris. I had John Arthorne’s name in my head as I was typing this and erroneously gave John credit where it was due Chris. Somebody please call me an idiot.

Chris Aniszczyk and Lawrence Mandel are taking a stab at revolutionizing the way that Eclipse articles are authored. And they’re taking a novel approach: why not use Eclipse to author articles about Eclipse?

In their article “Authoring in Eclipse“, Chris and Lawrence outline how Eclipse and WTP, combined with accepted document formatting standards (e.g. DocBook, DITA) can make authoring easier. I’m using the word “easier” selfishly: It certainly makes things a lot easier for me. For authors, there is certainly a learning curve as you get used to the format if you choose to work directly with the native format; it’s XML-based, so it’s not that hard, it’s just a little weird if you’re used to authoring documents using word-processing software. As the article suggests, there are editors available that understand the format (even one that’s an Eclipse plug-in) which should greatly decrease (though not totally eliminate) the entry cost of authoring in the format.

For me, the beauty of the process is that authors can build their documents without worrying about the format. The authors have provided transformations that will turn the document into HTML and/or PDF. The real power (for me) lies in the ability to rerender the documents into other formats when required. I can, for example, extract just the summary, date, and author information from the document to display on the articles landing page (and the Eclipse home page). All of the existing articles are in a pretty cruddy (and I feel comfortable using the term ‘cruddy’) format that I’d really like to update to something closer to the Phoenix look. At this point, I’m looking at hiring a student from the college across the road to go through the painful manual process of converting all these articles. If I had them all in DocBook format, I’d just rerender everything based on a new template.

I’m pretty excited about adding this new option for Eclipse authors. I invite authors to consider reading this article and using the template they provide. We’re not imposing this on anybody, but are instead providing this as an option.

Tags: 
Uncategorized
Source: 
https://waynebeaton.wordpress.com/2006/01/17/authoring-in-eclipse/
  • Wayne Beaton's blog
  • Sign in to post comments.

Eclipse Foundation Blogs

  • Ian Skerrett (857 posts)
  • Wayne Beaton (796 posts)
  • Mike Milinkovich (290 posts)
  • Benjamin Cabé (131 posts)
  • Ivar Grimstad (104 posts)
  • Tanja Obradovic (39 posts)
  • Thabang Mashologu (32 posts)
  • Christopher Guindon (15 posts)
  • Roxanne Joncas (14 posts)
  • Paul Buck (11 posts)
  • Frédéric Desbiens (11 posts)
  • Brian King (9 posts)
  • Mikaël Barbero (9 posts)
  • Jameka Woodberry (9 posts)
  • Hudson Kelly (8 posts)
  • Denis Roy (5 posts)
  • Gabriela Motroc (4 posts)
  • Shabnam Mayel (3 posts)
  • Gael Blondelle (3 posts)
  • Shanda Giacomoni (2 posts)
  • Sharon Corbett (1 posts)
  • Paul White (1 posts)
  • Jacob Harris (1 posts)
  • Stephanie Swart (1 posts)
  • Michael Plagge (1 posts)

Recent blog posts

  • Share Your News with an Eclipse Foundation Press Release
  • Eclipse Theia Blueprint Now Available for Download
  • Hashtag Jakarta EE #67
  • Three Good Reasons to Complete the Jakarta EE Developer Survey
  • Hashtag Jakarta EE #66
  • Why Java Developers Continue to Rely on Jakarta EE
  • Open VSX: A Vendor-Neutral Home for VS Code Extensions
  • Hashtag Jakarta EE #65
  • Introducing New Che Workspaces on OpenShift
  • Eclipse Jetty 11 Supports the Big Bang
More

Eclipse Foundation

  • About Us
  • Contact Us
  • Donate
  • Members
  • Governance
  • Code of Conduct
  • Logo and Artwork
  • Board of Directors

Legal

  • Privacy Policy
  • Terms of Use
  • Copyright Agent
  • Eclipse Public License
  • Legal Resources

Useful Links

  • Report a Bug
  • Documentation
  • How to Contribute
  • Mailing Lists
  • Forums
  • Marketplace

Other

  • IDE and Tools
  • Projects
  • Working Groups
  • Research@Eclipse
  • Report a Vulnerability
  • Service Status

Copyright © Eclipse Foundation. All Rights Reserved.

Back to the top