Skip to content

Commit 2691931

Browse files
committed
better configuration description
1 parent 8023893 commit 2691931

File tree

1 file changed

+18
-5
lines changed

1 file changed

+18
-5
lines changed

Chapters/IcebergIntro/StartedWithIceberg.pillar

Lines changed: 18 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -184,16 +184,26 @@ Now you can push your changes and versions to the remote repository using the ""
184184

185185
+Once you pushed you changes to the remote repository.>file://figures/S15-PushedFromReport.png|width=75|label=PushedFromReport+
186186

187-
!!!Configuring Pharo to commit in HTTPS/SSH
187+
!!! Configuring Pharo to commit in HTTPS/SSH
188188
@sec:Configure
189189

190-
Versioning code is just the first part of making sure that you and other developers can reload your code. We will now describe how to configure Pharo to automatically connect to be able to publish to github. In the next section we will describe how to create a baseline (a kind of map) to reload your application.
190+
We will now describe how to automatically configure Pharo to connect to github or other git related services.
191+
In the next section, we will describe how to create a baseline (a kind of map of your application and its package).
192+
A baseline will make sure that you can reload your application and all its packages.
191193

194+
!!!! Startup actions
195+
Pharo supports startup actions. Each time you will launch Pharo, Pharo will load some startup scripts and execute them. Basically all the file finishing by ==.st== located in your Pharo preferences folder will be executed.
196+
Some actions can be executed only once and others everytime. You can read more on this in the ==StartupPreferencesLoader== class.
192197

193-
With recent version of github, you should use a token to connect using HTTPS to be able to commit to your repository.
198+
199+
With recent version of github, to connect in HTTPS you should use a token.
194200
Now you can configure Pharo to store your token as well your github account authentification.
195201
In addition you can configure Pharo to point to your private and public SSH key as follows:
196202

203+
The following script should be placed in a ==.st== in your preferences folder (see below how to find it)
204+
and it will automatically configure Iceberg to connect to your accounts. Note that the first action of the script is to hide the Pharo logo.
205+
This way you can see if the startup script was executed.
206+
197207
[[[
198208
StartupPreferencesLoader default executeAtomicItems: {
199209
StartupAction
@@ -225,11 +235,14 @@ StartupPreferencesLoader default executeAtomicItems: {
225235

226236

227237
You should place this file in the preference folder that depends on your OS.
228-
You can find this place by using the ==Startup== menu. Note that you can configure this
229-
for all or one specific version of Pharo.
238+
You can find this folder by using the ==System== menu and its ==Startup/Version Preferences folder== item.
239+
To get the path of the folder, execute ==self fullName== in the inspector opened by the menu item. You should then place
240+
the script in file named ==xxx.st==.
241+
230242

231243

232244
!!! Defining a ==BaselineOf==
245+
Versioning code is just the first part of making sure that you and other developers can reload your code.
233246
We describe now how to define a ''Baseline'': a project map that you will use to define the dependencies within your project and its dependencies on other projects.
234247

235248

0 commit comments

Comments
 (0)