Baby Steps in Data Journalism

Starting from zero, this Tumblr provides tools, links and how-to information for people just beginning to explore data journalism.
Posts tagged "GitHub"

I installed GitHub for Windows on a university desktop computer, which is on a university’s hard-wired Internet/LAN. In many cases, including mine, that means there is a proxy server between my computer and the real Internet. (Download GitHub for Windows, free.)

That turned out to be the cause of my problem: When I tried to clone a repo using GitHub for Windows, or using the GitHub website, it would not work. When trying to clone with GitHub for Windows, the process always stopped at 9% of download and eventually gave me this message:

Failed to clone the repository …
Please check your internet connection.

What’s needed: You tell Git the address of the proxy server, and your username and password in the university system.

Here’s how:

First, find the URL (address) and port number of the proxy server.

How to find information about your proxy address (on Windows)

  1. Open Control Panel.
  2. Select Internet Options.
  3. Click the Connections tab.
  4. Click the LAN settings button.
  5. Copy and paste these two items into a plain text file:
    Address
    Port

Using your own login (username) and password (passw) for that network or computer, fill in the following

http://username:passw@www.secdomain.domain:8080

Then open PowerShell (Windows) and paste in the following (with your own info) ALL ON ONE LINE:

git config --global http.proxy http://username:passw@www.secdomain.domain:8080

NOTE 1: Make sure you have:

config [space] [hyphen] [hyphen] global

There is NO space between the hyphens and global.

NOTE 2: The stuff after the @ is the two items you copied from LAN settings in Internet Options (above).

NOTE 3: After I had installed GitHub for Windows on this Windows computer, I also installed the Git SCM. Get it here:

msysgit.github.io

Just download the installer .exe file and run it! 

Introduction for absolute beginners. Assumes you are a solo user, just getting started, for the first time. 

"The entire Pro Git book, written by Scott Chacon and published by Apress, is available here. All content is licensed under the Creative Commons Attribution Non Commercial Share Alike 3.0 license." 

"Quickly publish beautiful pages for you and your projects." 

Idea for teaching:

If each student sets up a free GitHub account —

They can make Gists, like this:

https://gist.github.com/macloo/5363602

Could these be used for peer grading? Easy to share.

Once the student has a GitHub account, he/she can write code in Codepen (http://codepen.io/) and automatically save to Gist from there.

Now, THIS is useful!!

This is a how-to.

At some point you may find yourself wanting to contribute to someone else’s project, or would like to use someone’s project as the starting point for your own. This is known as “forking.”

After you fork someone else’s repo (repository), it still exists only on GitHub. “To be able to work on the project, you will need to clone it to your local machine.”

Instructions are included.

Some things a beginner does not know:

The popular version control system used to be Subversion. Now it’s Git.

Git is faster than Subversion.

A version control system is “a simple command line tool for keeping a history on the state of your source code projects.” In other words, you preserve your old versions.

Branches:

Git developers routinely create, merge and destroy multiple branches a week, or even per day. Often each feature or bug you are working on can have its own branch, merged in only when it is complete.

> Download Git

.

futurejournalismproject:

NPR Apps best practices for READMEs, HTML & CSS, Javascript, GIT, and more.

Not only useful for wannabe journo-coders, but also helps you get a sense of NPR tackling traditional journalism issues like style consistency beyond the written copy in the modern technology. And props to them for making it available on GitHub.

milwaukeestat:

A good friend of mine recently questioned why I’d ever want to learn R or Python programing languages.

Yet, most of the good examples of code for data analysis and visualization that I have come across tend to be in either Python or R. So, I think I’ll stay the course with R and see if I can’t make some time for Python in the coming year.

(above: GitHub programming language usage)

jaheppler:

via JasonHeppler.org - History in the Digital

(via lifeandcode)