Creating content in the new Drupal site

Printer-friendly version

This page will instruct you on how to create content in this TW Website. We are using Drupal for our website.

What Content Type

The first thing you need to know is what kind of page are you wanting to create? "Well", you say, "I want to create a Page, it's just that simple!" Well, I say, not exactly.

In order to manage access control for the different pages, we have created different content types. There is a content type for each project worked on at the Tetherless World Constellation.

For example, you're a collaborator on the SeSF project, and you want to add content for the SeSF project. Anyone can see this content, but only SeSF collaborators can modify or delete this content. So you want to create a page with the content type SeSF Page.

Some content types have Taxonomy

For some content types, like Projects, we use a taxonomy. So, if you create a Project Page, a Course Page, and some other content types, you'll see a drop down menu underneath Tags with the different items in the taxonomy. Find your project in the drop down list and select it.

Permission to Create Content

"So, how do you know if you're able to create specific content types?" you ask. Well, after you log in, you'll get a black navigation bar at the top of the page. One of the menus is "Create Content", which is a drop-down list. When you click on this, you'll get a list of content types that you can create.

So, if you're an SeSF collaborator, you'll see SeSF page in that drop-down list. If you're an administrator, you'll also see SeSF page in your list, along with every other content type.

"Hey! I don't see the content type for the project I'm working on." Well, the mistake is all ours. Please let us know if you don't see the black navigation bar after you log in, or if you don't see the project content type for your project in the list. And we'll get that taken care of for you. Send an email to our TW Website Administrator, give us your user name, real name, email address, and the project you are working on. After we verify your identity, we'll get your permissions set up correctly.

Creating the page

So you've clicked on the project link in the "Create content" drop down list, and you see this form that pops up. A lot different from a wiki page, isn't it? (It's rhetorical, of course it's different.)

As an aside, the content type drop-down list has grown long since the website was initially created. In order to scroll the menu, you must also scroll the entire page while hovering over the Content Type menu (this can be done using a scroll wheel on a mouse or multi-touch on a Mac). If you do not have this functionality, you may visit http://tw.rpi.edu/web/node/add to see the entire list of Content types on a basic page.

This is the drupal form for creating new content. And this is what it all means.

Title

The Title is just that, the title that shows up in the browser's title bar and the Title that shows up at the top of the page.

Tags

Tags. The choice is None, or internal. Internal is for pages that only project people can see, edit, or delete. Nobody else can read it. Most pages should probably not be internal, so you need to select None. Really … you have to click on None.

Input Format

Input Format. "Hey", you say, "Body is next, not Input Format." Yes … I know that. I wish they had put Input Format first, though. What format you put the content of the body in depends on the format of the input that you select for this page. So, let's do that first.

Right now we have three choices. The default choice is Wiki Format. This is MediaWiki formatting, just like the old TW Wiki. Except, not everything works. So check what's available. If you are ok with Wiki formatting, you don't need to change anything. And this format could be useful for transferring content from the TW wiki to the drupal site.

Only administrators can use the Full HTML input format. Sorry 'bout that.

So your other option is "Filtered HTML", which allows a certain subset of HTML tags, including our special tag for querying and rendering triples from our external triple store.

Body

Now that we know the format that we'll be using in the Body, we can add the body of the page. The format of the body depends on the Input format that was set when creating the page. If set to "Filtered HTML", then only a small subset of HTML tags are allowed. If MediaWiki format was specified, then use MediaWiki markup. Again, unfortunately, not all MediaWiki formatting works. Please let us know if something doesn't work, and we'll get right on it.

If you want to link to media in the body of the document, then you do it using the tags for the format selected. If HTML, then you use the <a href="linkToMedia">Text here</a> Please visit the instruction page for uploading and linking to media files.

URL path settings

The next important setting is the URL path settings. If you don't see this setting, please let us know so we can give you permission to do this. Otherwise the URL of this page will be something like node/576.

Here you'll set the relative URL for this page. And we do have some naming conventions for you.

Revision information

For big changes to a page, we want you to keep track of what all was changed. So expand the "Revision information" section, click on "Create new revision" and enter a log message. Again, this is just when you make big changes to the page.

Comment settings

Do you want collaborators to be able to comment on the pages? For example, if you're creating a use case, and you want people to comment on what's already there, you can turn on comments.

To do this, expand the "Comment settings" section and click "Read/Write". When the comment period is over, you can click "Read only". If you've integrated all of the comments, and don't care to keep track of the comments, you can click "Disabled".

Now save the page

And that's all you really have to set. If you want to preview your changes before saving, click on "Preview" at the bottom. If you're satisfied with your changes, go ahead and click "Save".