Category Archives: Development

How use Tower with GitLab

So Academic Computing setup an instance of GitLab for version control, so I’m moving some things from both SVN and Github. We’re using Tower as a GUI, and it took me a bit to figure it out. But yesterday I did. ๐Ÿ™‚

  1. Make sure you have an account on git.evergreen.edu!
  2. Make sure you have an SSH key on your local machine set up in GitLab. Open Terminal and type in cat ~/.ssh/github_rsa.pub — if there’s stuff there, copy it including “ssh-rsa” and go all the way to the email at the end. Then open git.evergreen.edu, go to your profile, then go to SSH keys. The title should be something identifying your machine, and the code should be the code. Note that this assumes you have an SSH key from using github. So, yeah.
  3. Create an empty project on gitlab. (If you’re migrating an up-to-date repo on Github, there’s a setting for that. I haven’t used it yet, because I’ve been having issues updating my Github theme repo.) Copy the URL (I’ve been using the HTTPS URL, but SSH might work too?).
  4. Go into Tower, click on the Clone button, and enter the URL. Your username is your full evergreen.edu email. Follow the directions.
  5. What I’ve then done so far is copy the files from my old theme repository into the folder for my new repository. There’s probably some way better way to handle it.

And now you have a repository on gitlab and your local machine!

This week…

It’s been a little while since I’ve done a Week in Review!

This was the first week with the Web Team’s new designer, Justin McDowell. He’s getting himself set, which makes me realize how much I’ve already figured out in just four months. ๐Ÿ™‚ Also, how helpful my previous experience at Pierce College was, and how helpful it is to have two family members who attended Evergreen.

But now we can start to set up common processes and systems, toss out old stuff, start big new stuff. So that’s very cool.

This week I worked quite a bit on OARS (Online Academic Records System) — some personas work, which I find I really enjoy both the research and the writing. (I was a creative writing major at UPS. Go figure.) And also some UX work with the very first bit of the system. I’ve never done UX design in Excel, and yet for this piece it was exactly the right tool. Since, really, it’s just a table. The OARS project team has a cowork/meeting one morning a week, and we mostly worked on that — clarifying from what I’d done and what the lead developer had done, and getting to something that made sense to the whole team, and that we think will be good for students…someday.

I also did lots and lots of Google Analytics reporting, which can be mind-numbing, but then there are flashes of insight. Those are kind of delightful; it even included discovering that something I’d done was actually helpful to our site visitors, measurably so!

There’s been one incredibly dull project that’s also incredibly necessary to move some other projects along. TBH, it’s sort of nice sometimes to just have something quiet and routine to do.

Getting a rhythm down

I’m starting to get the hang of setting up structured content in Cascade! It’s a PITA, but can be routinized.

Experiment in oXygen to get the gist of what I want.

Figure out which things should be in the data definition and which things should be in the metadata. (It irritates me greatly that these two pieces are separate from one another.)

Set up the data definition.

Set up the metadata set.

Set up the configuration set. Have discovered that I really like the “calling-page” index block that I learned in training for the DEFAULT area. FWIW, have also discovered that I can’t get the XML configuration working in Global. ๐Ÿ™ So I have a testing “Site” set up on the dev server for doing the initial version of all of this. Which has the added benefit of keeping separate from all the existing site cruft.

Set up the content type.

Set up the folder & create the first item.

Copy the XML into oXygen, edit the XSLT to match the final product. Copy the XSLT into a format, edit the configuration set to apply the format. Tweak as needed.

If I need a list of items, which so far is always, create an index block of one sort or another, grab the XML, do XSLT in oXygen, etc. Create a page to hold the list, add block to “generated content” area, apply format.

Copy data definition XML and final XSLT files back to local drive.

Go into Global of dev server and do all that setup again, this time, copying and editing the relevant existing configuration set (to get the right template & all that). Tweak everything again as needed until it looks right. Save files locally again.

Once more, with enthusiasm…this time in the correct location on the live server. (Or if I need to show something before creating it in someone else’s folder, set up a folder & pages inside webresources.) Send for review, tweak, etc.

When everything is final, create the asset factory. Make sure to make the base item inside whatever _internal folder applies AND to set that item to not be indexed (in case you’ve got a content type index block). Asking aloud: if the base item isn’t set to be indexed or published, does that mean that new items created from it aren’t either? Hm.

Wondering also about adding index block pages to a publish set. Should that be part of the process, or should I leave it to content creators to publish the index when they publish the item? (Alternatively, any way to trigger publishing?)

I should probably just copy all of that into the team wiki and clean it up a bit. Pretty decent documentation, if I do say so. It’s convoluted, for sure, but not totally horrible. So far I’ve managed to avoid Velocity, which I found actually more annoying than XSLT. I didn’t think that was possible, but there it is. Mainly, I’ve worked out converting dates via an external XSLT that’s bundled in the common folder. (It doesn’t work at all locally, and I can’t for the life of me figure out why.) We’ll see what happens when I try to actually create a calendar.

Webinar: Summer of Learning (HTML5) session #1

Gah, I hate the idea that HTML5 is a catchphrase, and not simply a spec. :\

Nothing new to me here.

Still sad about HTML5’s loosey-goosey syntax. (anchor tag wrapping around multiple block level tags?!)

shim/shiv and/or modernizr. (I should probably go look at modernizr again. altho…interesting, it adds classes to the body to say what is & isn’t supported.)

Homework! “make the drink once you finish the assignment.”

Learning Rails, Take 2

I happened across Code School’s “Rails for Zombies” today (I’d seen a link to “Try Git“, was impressed, and started poking around), and holy cow, it might actually stick now!

Three things about it:

  1. Immediately they recommended going through “Try Ruby” if you didn’t already have familiarity with the language. That got me a taste of the syntax, which is pleasantly sane.
  2. There isn’t any futzing about with setting up an environment. Where I got stuck (initially) was just in setting up the environment on my machine.
  3. Lots of little bits of trial and error, following VERY short videos. With two monitors, I’ve got the slides open nearby so I can skim back and forth to see the exact syntax & whatnot. I’ve been doing all the extra credit just to get it to stick better.

So I’m optimistic.

Links

I added a widget for the “webdev” tag on my personal Pinboard account. I’m sort of a web-based magpie, and Pinboard has been my nest for a while. (As in, I was an alpha user, although I didn’t switch until…I’m not sure, maybe when there was a rumor that MS was buying Yahoo, and I got freaked out about Delicious? But before the rumor that Yahoo was closing Delicious, and before they actually sold it to the guys that started YouTube. Seriously, I’m glad Pinboard is one guy’s thing with an actual stable business plan.)

If you’re at all interested in the sorts of things that I’m following in the web development would, check it out. I get links from all over; some I save to read later, some as reference, and some just in the hopes that someone else will see & find it useful. Enjoy!

when you get lost at an easy step

It’s really hard to get up to speed learning something in a group if you get stuck or lost right off the bat with something that ought to be really easy. Thus, this micro-class in Ruby. Gonna start over from scratch later. Much later.

Also, curiously enough, I’m having a hard time using the laptop on its own, because I keep wanting to touch the screen to navigate, like I would on my Asus Transformer. On top of that, it doesn’t help that I don’t yet know my way around terminal on mac.

Doesn’t help either that it’s the middle of the afternoon, which is not my best time to do anything.