tonybaldwin | blog

non compos mentis

Posts Tagged ‘transprocalc

New TransProCalc manual

leave a comment »

Hi!

I just wanted to post quickly and let everyone know that, thanks to technical writer, Anindita Basu, we now have a brand new, shiny TransProCalc Manual available, both in on online version, and for download as a pdf document for the TransProCalc project.

I still have plans to step up development on the project and add all kinds of useful features…stay tuned.

Advertisements

Written by tonybaldwin

March 7, 2010 at 5:16 pm

TransProCalc, Google Code, & Subversion.

with 3 comments

A few days ago, as mentioned, I initiated the process of moving TransProCalc onto google code, feeling that it was time to dust off the project and move forward with it. I had merely signed the project up at that time, so, last night, before my brain turned to complete jello after spending the day slogging through the translation of some pretty heavy Brazilian academic articles, I took some time to configure the google code pages for the project, make a couple of wiki pages, upload the current, stable release, and, upload the existing code for the project.

Now, google code offers two version control systems, Subversion and Mercurial. I’ve never used either one before, but, at least I’ve heard of Subversion, so I chose to go with that one. It is, apparently, the default system, Mercurial offered as an option. I have used CVS before.

So, I aptitude installed subversion (svn) from the debian/lenny repos, and set about trying to import my code for the first time to the project.
The instructions on the google Subversion FAQ for importing your code are rather succint.

Just use the ‘svn import’ command.

.
Very thorough…
So, the first thing I did was, logically, try to read the man page. Now, people frequently complain that man pages are written for the hopelessly, inhumanly geeky, and not very useful for the rest of us (ok, I do write code, but I am far from being a real hacker, yet), that they are written in some secret language, and that they are generally useless. Of course, those in the know say to read them, and find them rather useful. I confess, I have actually come to the point where I can make sense of some man pages. I’m not even ashamed to admit it. Some of them are insanely usefl (ncftp, for instance, has a very thorough man page). So, I called up “man svn”.
This is what I got:

NAME
svn – Subversion command line client tool

SYNOPSIS
svn command [options] [args]

[sarcasm]That certainly cleared everything up for me…[/sarcasm]
How about explaining the options? What args? Hello!
I tried “svn help”, and that gave me a list of commands, as least, but with no explanation of how to implement them, or what they did, what options or arguments could be passed to them… Folks, the Subversion project needs documentation writers. No doubt. So, I did the next natural thing, then, and did some googling.
In defense of subversion, I must say, they have an entire book/manual for Subversion, available to be purchased in print, or read online for free. Perhaps the man page should give the link/location thereof, at least.
Of course, the instructions I found in said book was to import my code to my google code project, were a bunch of cryptic garbledy-gook, and said nothing of importing to a remote repository, only creating a repository on a local machine. I needed to import my code to a remote repository.
I did some ranting on some forums, to no avail of course (ah, but the sweet release of venting…), and did some experimenting.
I ended up resetting the repository a total of about 4 times, before I finally managed to figure out how to a) set up the svn repo at my end, b) import the code to google, and c) check in and check out.
So the code is up there, now.
Now, there do seem to be instructions available for checking out and checking in. That’s not too bad. But considering the complete lack of instruction on how to actually import the code of the first time, I thought I’d share the culmination of my efforts.

:~$ cd /path/to/project/files
:~$ svn import https://projectname.googlecode.com/svn/trunk/ –username yourname

There! Your code is imported to the svn repo… I know; Looks simple, but there was nowhere that I could find an explanation thereof.
(okay, it might as well be martian to some of you, dear readers, but those who write code and participate in open source software projects will understand).
Happy? I am.

So, TransProCalc is now up on google code and ready to start a new life. I actually made a few minor changes to the code already, last night, before loading it up there, but not enough that I would call it a release or new version…just a little clean up, rewrote the install script, and, more than anything, a lot more commenting, since I’m hoping to have collaborators. Commenting your code makes it easier for others to find stuff and figure out what you’re doing.

And, happily, I have a collaborator already! Anindita Basu, who had previously written a manual for TransProCalc, has rejoined the project (it’s been out of development for nearly 2 years, recall).

I have big plans for TransProCalc, many new features to be implemented, including but not limited to incorporation of a providers and client db, more user configurability of project parameters, and a calendar/reminder system to annoy you when invoices are due (either to you, or to your providers).
No time to work on any of that today, though…back to these articles…

Written by tonybaldwin

March 3, 2010 at 8:10 am

transprocalc – free translation project management tools *MUCHO TODO*

with 2 comments

I’ve decided I need to drag out the transprocalc code and get hacking again.

TransProCalc is a little program I sarted building back in late 2007/early 2008, when I was outsourcing a lot of translation work, and found that the time I was spending managing the projects didn’t justify the meager profits I was making from outsourcing. I determined that I really needed to find a way to automate parts of the process, and I couldn’t find any existing free/open source software projects that would meet my needs. I was “scratching an itch”, as they say in the hacker community. I had a need; I started hacking.

TransProCalc IS handy, too. It helps me keep track of all the documents and assignments for a project, and crunch of the financial numbers, and spits out handy little reports. It needs work, though. I want to get it playing with a database to manage information on clients and providers, get it hooked up with a real calendar/reminder system, to remind me when invoices are due (to providers, or from clients), keep track of which clients have online invoicing systems and help me automate the process of dealing with those, etc….much trabajo.
I have good ideas on how to get a lot of that accomplished, but I need to set aside some time to get to work on it.
Additionally, I would not mind other devs jumping on board with the transprocalc project.
I added transprocalc on google code this morning, which may assist in finding other hands to get into that code, perhaps, and provide tools to manage the project.
Of course, it is already on sourceforge, too.
At the moment, I have some academic articles from Brazil to translate that are keeping me pretty busy.

Furthermore, I have a lot of really good friends in Santiago, Chile, where there was an 8.8 earthquake early this morning.
So, today, I am spending a lot of time, today, worrying about them and trying to track them down and make sure everyone is okay, and obsessively checking the news, etc… ¡VIVA CHILE, MIERDA! (a todos los chilenos, les quiero mucho, mando abrazos, cuidense)

Written by tonybaldwin

February 27, 2010 at 11:21 am

TransProCalc 0.8

leave a comment »

TransProCalc 0.8

New release of TransProCalc, free translation project management software…

I had not intended to release at this juncture, but, a user wrote to me and pointed out a minor error in my intall.sh script (was cd-ing to /usr/loca/bin instead of /usr/local/bin to chmod to a+x for all the scripts…doh).
So, I fixed the install.sh, but also released the new tabbed/notebook arrangement.
The code has been cleaned up a bit, and has better commenting, too, if for no other reason than to make it easier for myself to find stuff while hacking away at it.

I’ve been working on writing in the math to round the figures, as per ‘s suggestion, but, have not completed that, so rounding is not part of the new release.

I’m hoping to have that done by the end of this month, and will be releasing again.
I’m also going to add a fourth report, a report that includes information from all three windows.
As it is, I usually make on by copy/pasting parts of the three existing reports together, so, I figure
it would be useful to others, too, to have this one report.
I’m also thinking about adding an invoice generator, although, I imagine that most folks
already have their own method for generating invoices.
I could even add export of the invoice to pdf format.
What do you think of that idea?
I would like to write in some user configuration…you know, saving the user’s pertinent information for the purposes
of generating said invoices, and, also, the ability to save information for clients, and, thus, a fourth tab in the notebook for
a client info input dialog, where one can enter, then save information for each client, such as address info, etc.,
to sort of build a client database for transprocalc.

My intention was to work on some of these items this week, in fact, and not to post a new release until these
items were completed, but, since the install script needed attention, I figured I’d at least amend that little issue,
and, since the tabbed/notebook feature was already completed and in use here, I figured I’d release it as such.
So, there you have it: TransProCalc 0.8 is up.
Enjoy.
When I get these other features written in , I’ll be releasing 1.0

Anyone want to come on board and help code some of this stuff in?

Any ideas or feedback, too, are always welcome and appreciated.

Written by tonybaldwin

May 11, 2008 at 9:31 pm