comparison README.md @ 101:6271c701830d

Document the usage of the foundation 5 framework.
author Kai T. Ohlhus <k.ohlhus@gmail.com>
date Wed, 02 Nov 2016 10:47:48 +0100
parents e7efa40deb17
children a65746fafc90
comparison
equal deleted inserted replaced
100:2b8c5b40da84 101:6271c701830d
73 To build the static website, you need to install [Jekyll][6] and a few more 73 To build the static website, you need to install [Jekyll][6] and a few more
74 tools from [Rubygems][7]. Just type 74 tools from [Rubygems][7]. Just type
75 75
76 gem install jekyll pygments.rb 76 gem install jekyll pygments.rb
77 77
78 For the responsive webpages, we internally use the [Foundation 5][8]
79 framework. All necessary files are already included inside the
80 [hg development repository][2].
81
78 [7]: https://rubygems.org/ 82 [7]: https://rubygems.org/
83 [8]: http://foundation.zurb.com/sites/docs/v/5.5.3/
79 84
80 85
81 86
82 ### Building the static website 87 ### Building the static website
83 88
114 Duplicate another post in the subdirectory `_posts` and 119 Duplicate another post in the subdirectory `_posts` and
115 adjust the filename, especially the date 120 adjust the filename, especially the date
116 121
117 122
118 123
119
120
121 ## Deploying 124 ## Deploying
122 125
123 After building the static website from [web-octave][2] into the 126 After building the static website from [web-octave][2] into the
124 the subdirectory `_site` using Jekyll it can be deployed at the 127 the subdirectory `_site` using Jekyll it can be deployed at the
125 [Savannah CVS][3] repository to become visible to the world. 128 [Savannah CVS][3] repository to become visible to the world.
129 132
130 export CVS_RSH=ssh 133 export CVS_RSH=ssh
131 cvs -z3 -d:ext:<Savannah account>@cvs.savannah.gnu.org:/web/octave checkout -P octave 134 cvs -z3 -d:ext:<Savannah account>@cvs.savannah.gnu.org:/web/octave checkout -P octave
132 135
133 Now the following steps are required for deployment 136 Now the following steps are required for deployment
134 (see [here][8] and [here][9] for some introduction to CVS): 137 (see [here][9] and [here][10] for some introduction to CVS):
135 138
136 1. Remove all previous files in the target directory, 139 1. Remove all previous files in the target directory,
137 *but no directories at all or CVS related stuff*! 140 *but no directories at all or CVS related stuff*!
138 This is due to a [limitation of CVS][10]. 141 This is due to a [limitation of CVS][11].
139 142
140 find octave -type f -not -path "*/CVS/*" -exec rm -f '{}' \; 143 find octave -type f -not -path "*/CVS/*" -exec rm -f '{}' \;
141 144
142 *Note:* `octave` in the command above is the name of the checked out 145 *Note:* `octave` in the command above is the name of the checked out
143 [Savannah CVS][3] repository. 146 [Savannah CVS][3] repository.
155 158
156 2. Add all potential new directories to CVS 159 2. Add all potential new directories to CVS
157 160
158 find . -type d -not -name "CVS" -exec cvs add '{}' \; 161 find . -type d -not -name "CVS" -exec cvs add '{}' \;
159 162
160 3. Add all potential new files to CVS (the [following command][11] 163 3. Add all potential new files to CVS (the [following command][12]
161 proved to me fast) 164 proved to me fast)
162 165
163 find . -type f | grep -v CVS | xargs cvs add 166 find . -type f | grep -v CVS | xargs cvs add
164 167
165 4. Commit the chages to get online 168 4. Commit the chages to get online
166 169
167 cvs commit 170 cvs commit
168 171
169 Now everything should be visible to the world. 172 Now everything should be visible to the world.
170 173
171 [8]: https://savannah.nongnu.org/projects/cvs 174 [9]: https://savannah.nongnu.org/projects/cvs
172 [9]: http://www.cs.umb.edu/~srevilak/cvs.html 175 [10]: http://www.cs.umb.edu/~srevilak/cvs.html
173 [10]: https://web.archive.org/web/20140629054602/http://ximbiot.com/cvs/manual/cvs-1.11.23/cvs_7.html#SEC69 176 [11]: https://web.archive.org/web/20140629054602/http://ximbiot.com/cvs/manual/cvs-1.11.23/cvs_7.html#SEC69
174 [11]: http://stackoverflow.com/questions/5071/how-to-add-cvs-directories-recursively 177 [12]: http://stackoverflow.com/questions/5071/how-to-add-cvs-directories-recursively