tools to run ThreeFold web env

starting point to run all wiki's and websites on your local machine

wiki's
websites

to install

copy the following in your terminal, will install the tools (OSX only for now).

/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/crystaluniverse/publishtools/master/scripts/install.sh)"

Requirements

Make sure your ssh-key is loaded and you have it in your github account

quick instructions

install & run

#install the publishtools
publishtools install
#re-install (if something is wrong, do an install -reset)
publishtools install -reset
#re-install and pull newest website code in
publishtools install -reset -pull
#list the known sites(will show if changes in the repo)
publishtools list
#start development mode of website cloud (specify part of name of website is good enough)
#is using gridsome
publishtools develop -r cloud
#run the webserver for the wiki's
publishtools develop
#build all websites & wiki's, will take long time
publishtools build
#specify to build for 1 specific website (name is part of name)
publishtools build -r cloud

remark: this will checkout all relevant repo's on ~/codewww

develop / commit

#list repo's show if there are changes
publishtools list
#commit changes, specify repo name
publishtools commit -r info_cloud
#commit changes, specify part of repo name
publishtools commit -r info_
#commit changes, specify commit message
publishtools commit -r info_ -m 'my message'
#commit changes, specify commit message, no quotes, cannot have spaces then
publishtools commit -r info_ -m mymessage
#commit same message on all repo's
publishtools commit -m mymessage
#commit & push changes (message & repo are optional)
publishtools pushcommit -r info_ -m 'my message'
#pull changes from github (repo name is optional)
publishtools pull -r info_
#push changes to github (repo name is optional)
publishtools push -r info_

edit code for a website/wiki

#open code editor (visual studio code)
publishtools edit -r legal

remarks

when specifying a name for edit, will open the first repo it finds which matches the name
for using edit, you need visual studio code installed with command line integration
- see https://code.visualstudio.com/docs/setup/mac the launching from command line
make sure your ssh-agent is loaded !

work with your ssh keys

see instructions

recommended tools

sourectree (manage your git repositories)
ms visual studio code

advanced usage

#will go over all repo's and update the repo's after cleaning up e.g. the wiki's
#a lot of automation happens here, be careful
publishtools install -clean

scottyeager/publishtools