AniDB:CSS DEV: Difference between revisions

This pages content is centered around CSS development via Anidb's [http://en.wikipedia.org/wiki/Subversion_(software) SVN]. The goals of the SVN are:

# Automatical upload procedure to one of anidbs server.

# Automatical update of the drop down menu in the [[profile]].

If you only want to get the latest version of all files belonging to a particular style, you don't need to install an SVN client. A simpler approach would be to download the files from the SVN repository with your webbrowser.

First thing you need is a client. You can of course use any svn client you want, but we recommend [http://tortoisesvn.tigris.org/ Tortoise SVN] for windows user as it nicely integrates into Explorer and makes it, as such, very easy to use. After that you specify a dir on your hdd where you want to put the files and checkout the current CVS version.

For Mac users we recommend [http://rapidsvn.tigris.org/ RapidSVN]. RapidSVN does not integrate with the Mac Finder as much as Tortoise does with Explorer. Instead it is a standalone app that you use to browse the files on the SVN server (Repository) as well as your local files (Working Copy).

After installing a version and having picked a dir, where to put your stuff right click in the new dir and select '''checkout''' In the following dialog enter svn://dev.anidb.net/svn/trunk/ in the url field. This will download the whole content of the svn to this dir. After this is done you will notice a green thingy in the file and dirname icons. (This means your local version matches the version in the SVN Once you edit any file it will turn red)

To add new content you can create new files and dirs like you are used via explorer. Editing the files can be done via any editor you want as well. You will notice no green thingy turning up for anything new you created. This means the file is not in the svn and hence not recognized. You have to add them first. In the context menu you will find an option who would have guessed it named '''add'''. This only creates a placeholder in the SVN. No actual content is written yet.

Deleting things works analog. You first have to delete the placeholder.

You may now create/edit/delete any files or folders in your working copy dir.  Any changes you make will be automatically recognized and highlighted in the RapidSVN file browser: items edited or deleted will have a red icon,  and items created will have a question mark icon.  To add created items to the SVN right click on them and choose '''Add''' (or select them and hit '''cmd+A''').  Note that Adding only lets them be recognized by the SVN, it does not commit their creation to the server. To commit changes, select the files, right click and choose '''Commit'''. You will be given a dialog box in which you may annotate what this commit entails. You may choose to leave this blank, but it's good practice to log your changes so others know what you've changed.

# Add a new dir for your project in the css folder (<tt>/trunk/css/{your_style}</tt>)

#* You may use subfolders below that one if you want.

# (optional) For autoprocessing edit the '''styleslist''' file and add a relative path for the main css file (the one with all your <tt>@import</tt> lines, i.e. <tt>./sub/silver/main.css</tt>)

Every css that is used this way gets merged into 1 file (to reduce http overhead), uploaded to 1 of anidb's server and added to the style selection in the anidb [[profile]]. To realize this a python script is used, doing the following:

# takes the first line from '''stylelist''' and reads the main css file for this style

# checks if there are is an /images/ folder below the css folder and if yes collects a list of all gif/jpg/png files

# uploads the big css file and the images to 1 of anidb's server