A tool based on donated statistics that helps organizations better estimate the time and other costs related to digitization projects.
Windows requires a few additional requirements that you will need to install:
- Atom - A much nicer text editor than Notepad...
- git - We need this for the git-bash client
- node - For running a local web server
- RailsInstaller - For generating the JavaScript dataset
- GitHubDesktop - For version control/publishing the website
- GitHub Account - An account on GitHub
After installation of these, you'll need to "clone" the repository. You can do so by clicking on the green "Clone or Download" button on the project page.
It doesn't matter where you save it, but you'll need to remember where it is. I always set my project location to C:/Users/%user%/projects/. Again, just remember where you save it to.
Make sure the branch says gh-pages.
In the GitHub Client, right click on the digitization_cost_calculator project and select "Open in Terminal".
In this terminal session, type:
npm install
bundle
After this is finished installing everything, in the terminal type gulp. This will start a webserver on you machine and open your browser to the page http://localhost:3000. Whenever you save a file, this will rebuild the site and refresh you page so you should see your update immediately.
To stop the webserver, hit ctrl + c.
In the GitHub Client, right-click on the digitization_cost_calculator project and select Open in Atom. This should launch in Atom.
After you've made changes, you should see a list of changes under the "Uncommitted Change" tab at the top of the GitHub Client. Add a Summary of the changes you made a brief description of what changed. Then click on the Commit to gh-pages button to publish the change.
This is important, you then need to sync these changes by clicking on the Sync button in the top-right.
All of the commands are run through the terminal. You can make this a nicer experience with iTerm2 and bash-it.
- Make a projects directory (
mkdir -p ~/projects) - Clone the repository to your computer (
cd ~/projects && git clone https://github.com/clirdlf/digitization_cost_calculator.git) - Change to the project directory (
cd ~/projects/digitization_cost_calculator) - Install the dependencies (
bundle && npm install) - Start the Jekyll server (
gulp) - Open the project in your browser at http://localhost:3000 (it should open automatically though)
- Celebrate 🎉
- Make sure you're on the master branch (
git checkout master) - Pull from origin: (
git pull master origin)
- Commit your changes
- Merge to the master branch (e.g.
git checkout master && git merge branch) - Push to github (
git push origin master) - Verify your update works at https://clirdlf.github.io/digitization_cost_calculator
- git
- Github Account
- Jekyll
- npm
- Ruby: Installed by default on OS X; for Windows users, use the Rails Installer
- Create an issue to discuss your idea.
- Fork it
- Create a feature branch (
git checkout -b my-new-feature) - Commit your changes (
git commit -am 'Added my awesome feature') - Push the branch (
git push my-new-feature) - Create a Pull Request
- Profit! ✅
The Digitization Cost Calculator is licensed under the terms of the Apache 2 license.