The ECEn XML Web Templates (v. 3_7)
This page is under construction. Some of the information
may be inaccurate or incomplete. Thank you for your patience as we
continue to work at developing a useful and attractive web site. If you have suggestions
or comments or would like to see completion of this page given special
priority, please let us
know. For the most recent version of
the Web Templates Help...
These are the version 3_7 ECEn XML Web Template help pages.
Both the templates and the help pages may have been updated
since this version---if you want to see the most current
stable version of the templates, go here. Note, however, that some of the information contained in more
recent versions of the documentation may not apply to you if you
are using an older version of the templates.
First, Can I Ask a Question? --- the F(CIA)AQ
 | What is XML?
XML is a markup language. A markup language is a way of taking regular old
text and telling computers what the various parts of it are.
|
 | Why XML? Basically, because XML is a useful tool for organizing all kinds of content and works well for
web pages too.
|
 | HTML vs XML. If you know HTML, it would be a good idea to understand the critical differences between XML and HTML.
|
The ECEn XML Web Templates
 | Why should I use the ECEn XML Web Templates? They are easy to use: just define your content in terms of the ECEn XML and let the ECEn Web Team
worry about making the web page match the look and feel of the department and the university.
|
 | Are they easy to use? They're designed to be anyway... XML is easy to write and if you don't want to write a lot of XML, you can use Microsoft Word 2003, with our WordML tool, to eliminate most of the XML writing.
|
 | So, is there any other way? Yes, we do have static HTML templates if you enjoy using Microsoft Front Page or Mozilla Composer,
but we recommend the XML templates.
|
 | Are these templates Windows friendly? Yes! You can easily edit XML and use the ECEn XML web templates on any platform. There are all
kind of free XML editors available for Windows and Linux alike and the WordML tool allows you to
create most of your web page content in Microsoft Word 2003 if you like.
|
 | What goes on behind the scenes? The great thing about the ECEn XML templates is that you don't have to worry about how it all works, but if you're curious, we'll explain.
|
Howdy, World! --- Making Your First ECEn XML Web Template-Driven Page
The Howdy World Tutorial is a simple, hands-on tutorial with bits of explanation
along the way. Requires that you have access to some
web space on the ECEn web server.
Directories and Filenames
Using a text editor (like Notepad, WordPad, emacs, or vi) to edit XML
General XML Fundamentals is a short list explaining several important aspects of XML, with special emphasis when XML differs
from HTML.
ECEn Web Template XML Basics
A simple class home page using the ECEn XML Web Templates
The Common Tasks page
is a collection of "How To's" covering some of the common tasks in creating a standard web page using
the ECEn XML Web Templates. We've included how to create links, lists, pictures, menus, tables and more.
If you can't find how to create something that you need for your web page in these common tasks, just
email the ECEn Web Team and we'll help you get what you need done and we might even add your common task to this page. These instructions assume that you already have a ECEn XML web page
to edit and know at least a bit about XML. Most content, such as text, links, lists, pictures etc., belong in the <content> portion of your page, so make sure that you
have a page with a <content> portion. If you need a quick tutorial or
just a simple starter web page download, check out the Howdy, World Tutorial where you can get brief overview on what files you need to set up a basic
ECEn XML web page. Expanding and Collapsing Sections
Common XML Files to include
This should include both XML files that can be downloaded and
included as well as the locations of typical 'canonical' files
to include.
Need help? We understand. Nothing can be so frustrating as to bring up your favorite web browser, expect to see your lovely new webpage, and instead be presented with a blank white screen or some XML parse error. Luckily, there are really only a few common errors people run into when using the ECEn XML Web Templates and they are all fairly easy to fix. Browsing through these troubleshooting pages will help you solve common problems, avoid problems in the future, and report bugs in the template system. Broken XML: finding mis-matched tags
Broken XML, cont.: '<' and '&' run amuck
Getting strange parse errors instead of your web page? Zap these errors by handling '<' and '&' run amuk.
Whitespace between tags, and in general
See a blank, white page instead of your web page? Get your page back by
fixing broken .phtml files.
Open an XML file to see all of the XML on one line with little boxes
everywhere? Learn how to fix hard to read XML files.
Bugs in the ECEn Templates
Think something is wrong? Can't add something to your XML web page you think you should? You might have found a bug in the ECEn Templates. Learn how to report it to help us make the templates better.
Using MS Word 2003 to create ECEn XML Web Pages
The WordML tool enables you to create web page content using Microsoft Word 2003, using headings, styles, tables and
the like.
The wonders of Copy and Paste
Escaping into 'real' HTML
ECEn XML Web Templates Reference
The ECEn XML Web Templates Reference contains a
detailed listing of the XML tags and their
contents in (roughly) document order. If you're wondering what
a particular tag does or whether there's a tag to do what you
want, this would be a good place to look. It can also serve as
a sort of crash-course for the templates for advanced users and
those who prefer a steep learning curve :). The reference page is quite large and may take a while
to load.
|