|
|
| (25 intermediate revisions by 2 users not shown) |
| Line 2: |
Line 2: |
|
| |
|
| PHP/SQL/HTML/CSS and Delphi (Object Pascal) are my preferred languages.<br> | | PHP/SQL/HTML/CSS and Delphi (Object Pascal) are my preferred languages.<br> |
| I'm pedantic about code etiquette (indents, spaces, etc).<br>
| |
|
| |
|
| New to Perl but interested in learning. I have a basic perl virtual host set up on my dev machine. Also got the slashdev virtual machine going, which makes the prospect of being able to contribute something that might be considered useful to the project a bit more likely.<br>
| | Look out for me on Soylent IRC (#Soylent and #)<br> |
|
| |
|
| Look out for me on #Soylent IRC.<br>
| | http://soylentnews.org/~crutchy/ |
| | |
| Crutchy's perl journal: http://soylentnews.org/~crutchy/journal/72
| |
| | |
| Code doc project: http://soylentnews.org/~crutchy/journal/82
| |
| | |
| slashdev journal: http://soylentnews.org/~crutchy/journal/114
| |
| | |
| Watch pages:<br>
| |
| [[Style]]<br>
| |
| [[CssWork|CSS Work]]<br>
| |
| | |
| ==Unit testing==
| |
| An area that I've been getting into a bit more with some of my other (mainly php) work. It's supposed to be that you write the tests first, but since slashcode is already written it's a bit hard to do that, but some kind of automated regression testing framework probably wouldn't hurt.
| |
| | |
| ==Code style==
| |
| Perl programming style guide:<br>
| |
| http://perldoc.perl.org/perlstyle.html
| |
| | |
| Just to start the ball rolling ("borrowed" from perl.org):
| |
| * closing curly bracket of a multi-line BLOCK should line up with the keyword that started the construct
| |
| * 4-column indent (slashcode uses tab indents, but in gedit you can set tab width or raplace tabs - tab may be better anyway?)
| |
| * Opening curly on same line as keyword, if possible, otherwise line up
| |
| * Space before the opening curly of a multi-line BLOCK
| |
| * One-line BLOCK may be put on one line, including curlies
| |
| * No space before the semicolon
| |
| * Semicolon omitted in "short" one-line BLOCK
| |
| * Space around most operators
| |
| * Space around a "complex" subscript (inside brackets)
| |
| * Blank lines between chunks that do different things
| |
| * Uncuddled elses
| |
| * No space between function name and its opening parenthesis
| |
| * Space after each comma
| |
| * Long lines broken after an operator (except and and or )
| |
| * Space after last parenthesis matching on current line
| |
| * Line up corresponding items vertically
| |
| * Omit redundant punctuation as long as clarity doesn't suffer
| |
| If anyone has any others or wants to change any, feel free to do so. Maybe add a reason/background in change summary just so others know where you're coming from.
| |
| | |
| We should maybe make a wiki page for coding style and develop it so that all our code is readable and consistent regardless of author.<br>
| |
| Also looking for one for other languages used for Soylent: CSS, HTML, JS, SQL
| |
| | |
| Goes without saying, but HTML and CSS should be W3C compliant.
| |
| | |
| ==Slashcode==
| |
| IHMO there are way too many folders nested in the slashcode source tree. There may be good reasons but I generally prefer a flat filesystem (as much as possible anyway) for code accessibility. Also helps to reduce likelihood of duplicate filenames. In the slashdev virtual machine I noticed that the apache public directory has links to a lot of the key files in a single directory, which makes things a lot easier.
| |
| | |
| What do other devs think of prefixing function names with source filename?<br>
| |
| For example, main() function in article.pl becomes article__main()<br>
| |
| Not suggesting that it all be changed to suit this convention right away, but might be handy for new functions to make it easier to figure out where things are declared.
| |
| | |
| gedit identifies a syntax error in shtml.pl getFileText function (line 74). Looks like a rogue "s" after the "!-" operator.
| |
| | |
| ===slashcode files of interest===
| |
| https://github.com/SoylentNews/slashcode/blob/master/themes/slashcode/htdocs/article.pl
| |
| | |
| https://github.com/SoylentNews/slashcode/blob/master/themes/slashcode/htdocs/comments.pl
| |
| | |
| ==Git/GitHub==
| |
| | |
| Useful information for beginners:
| |
| | |
| https://help.github.com/articles/set-up-git
| |
| | |
| https://help.github.com/articles/create-a-repo
| |
| | |
| https://help.github.com/articles/fork-a-repo
| |
| | |
| https://help.github.com/articles/using-pull-requests
| |
| | |
| <pre># apt-get install git</pre>
| |
| | |
| <pre>
| |
| $ git config --global user.name "crutchy"
| |
| $ git config --global user.email ""
| |
| $ git config --global credential.helper cache
| |
| $ git config --global credential.helper 'cache --timeout=3600'
| |
| </pre>
| |
| | |
| In my case /var/www/slash is served by apache2 (just on local network). This will be different if you're using the slashdev VM.
| |
| <pre>
| |
| $ cd /var/www/slash
| |
| | |
| $ mkdir git
| |
| $ cd git
| |
| </pre>
| |
| This creates the directory where I will keep local copies of all my git projects.
| |
| | |
| I started by creating a new repository called "test". Just for kicks. Can be deleted later.
| |
| <pre>
| |
| $ mkdir test
| |
| $ cd test
| |
| </pre>
| |
| You're now in /var/www/slash/git/test
| |
| <pre>
| |
| $ touch README.md
| |
| $ git init
| |
| </pre>
| |
| A commit is essentially a snapshot of all the files in your project at a particular point in time.
| |
| <pre>
| |
| $ git add README.md
| |
| $ git commit -m "first commit"
| |
| </pre>
| |
| So far, everything you've done has been in your local repository, meaning you still haven't done anything on GitHub yet.
| |
| To connect your local repository to your GitHub account, you will need to set a remote for your repository and push your commits to it.
| |
| | |
| Create a remote named "origin" pointing at your GitHub repository (repository name is case sensitive):
| |
| <pre>$ git remote add origin https://github.com/crutchy-/test.git</pre>
| |
| | |
| Send your commits in the "master" branch to GitHub:
| |
| <pre>$ git push -u origin master</pre>
| |
| | |
| ===FORKING THE "slashcode" REPOSITORY===
| |
| | |
| click the fork button on the Soylent/slashcode repository github page @ https://github.com/SoylentNews/slashcode
| |
| | |
| <pre>$ cd /var/www/slash/git</pre>
| |
| | |
| Download files into a subfolder named slashcode:
| |
| <pre>
| |
| $ git clone https://github.com/crutchy-/slashcode.git
| |
| $ cd slashcode
| |
| </pre>
| |
| | |
| When a repository is cloned, it has a default remote called "origin" that points to your fork on GitHub,
| |
| not the original repository it was forked from. To keep track of the original repository,
| |
| you need to add another remote named "upstream"
| |
| | |
| <pre>$ git remote add upstream https://github.com/SoylentNews/slashcode.git</pre>
| |
| | |
| Push commits to your remote repository stored on GitHub:
| |
| <pre>$ git push origin master</pre>
| |
| | |
| ===PUSHING CHANGES TO crutchy-/slashcode REMOTE REPOSITORY ON GITHUB===
| |
| | |
| Add any files modified to the git commit index:
| |
| <pre>
| |
| $ git add "plugins/Ajax/htdocs/images/core.js"
| |
| $ git add "themes/slashcode/templates/dispComment;misc;default"
| |
| </pre>
| |
| Commit the changes to the local repository index:
| |
| <pre>
| |
| git commit
| |
| </pre>
| |
| Nano will open with a commented summary of indexed changes.
| |
| | |
| You must enter a commit message.
| |
| | |
| ^O followed by ^X to save and close nano.
| |
| | |
| Will get something silimar to following:
| |
| <pre>
| |
| [master d573b6d] collapsing/expanding comment tree. changed js function to something more generic.
| |
| 2 files changed, 13 insertions(+), 1 deletions(-)
| |
| </pre>
| |
| | |
| ===UPSTREAM CHANGES===
| |
| | |
| Fetch any new changes from the original repository:
| |
| <pre>$ git fetch upstream</pre>
| |
| | |
| Merge any changes fetched into your working files:
| |
| <pre>$ git merge upstream/master</pre>
| |
| | |
| ===WORKING OUTSIDE SLASHDEV VIRTUAL MACHINE===
| |
| | |
| From within VM, to to Devices menu and click "Shared Folder Settings...".
| |
| | |
| Create a shared machine folder (-readonly,+automount,+permanent) to the /var/www/slash/git/slashcode directory on the host machine.
| |
| | |
| In a terminal inside the VM:
| |
| <pre>
| |
| $ sudo adduser slash vboxsf
| |
| </pre>
| |
| | |
| Reboot VM.
| |
| | |
| Again, from a terminal inside the VM:
| |
| <pre>
| |
| $ rm /srv/slashdev/slashcode
| |
| $ ln -s -T /media/sf_slashcode /srv/slashdev/slashcode
| |
| </pre>
| |
| | |
| Need to make sure your VM time is set a bit ahead of your host machine time to avoid "Clock skew detected." errors when running deployslash.sh script inside the VM.
| |
| I noticed that deployslash.sh script takes a little longer to finish, but does eventually finish.
| |
| Tested and seems to work fine for me.
| |
| | |
| ===GIT SHELL SCRIPTS===
| |
| | |
| Fetch and merge changes from the upstream remote SoylentNews/slashcode repository:
| |
| /var/www/slash/git/slashcode-upstream.sh
| |
| <pre>
| |
| #!/bin/bash
| |
| | |
| cd /var/www/slash/git/slashcode
| |
| git fetch upstream
| |
| git merge upstream/master
| |
| | |
| exit 0
| |
| </pre>
| |
| | |
| ==IRC logging bot==
| |
| | |
| had a go at scripting a little quick & dirty irc bot for soylent.
| |
| | |
| requires sic (http://tools.suckless.org/sic)
| |
| | |
| if you're using debian:
| |
| <pre>sudo apt-get install sic</pre>
| |
| | |
| <pre>
| |
| #!/bin/bash
| |
| | |
| chan="#test"
| |
| log="test.log"
| |
| pipe="log-pipe"
| |
| | |
| trap "rm -f $pipe" EXIT
| |
| | |
| if [[ -f $log ]]; then
| |
| rm $log
| |
| fi
| |
| | |
| if [[ ! -p $pipe ]]; then
| |
| mkfifo $pipe
| |
| fi
| |
| | |
| substr="End of /MOTD command"
| |
| joined=""
| |
| | |
| sic -h "irc.sylnt.us" -n "log-bot" <> $pipe | while read line; do
| |
| if [[ -n "$line" ]]; then
| |
| echo $line >> $log
| |
| fi
| |
| if [[ -z "$joined" ]] && [[ -z "${line##*$substr*}" ]]; then
| |
| joined="1"
| |
| echo ":j $chan" > $pipe
| |
| fi
| |
| done
| |
| | |
| exit 0
| |
| </pre>
| |