~ubuntu-branches/ubuntu/raring/gnome-user-docs/raring-proposed

<para>Il dialogo <guilabel>Esegui applicazione</guilabel> consente l'accesso alla riga di comando. Quando si esegue un comando nel dialogo <guilabel>Esegui applicazione</guilabel>, non è possibile ricevere l'output dal programma.</para>

<para>Per eseguire un comando dalla riga di comando, procedere come segue:</para>

<para>Mostrare il dialogo <guilabel>Esegui applicazione</guilabel>. È possibile mostrare il dialogo <guilabel>Esegui applicazione</guilabel> in uno dei modi seguenti: <variablelist><varlistentry><term>Da un pannello</term><listitem><para>È possibile aggiungere l'oggetto <application>Esegui applicazione</application> ad un qualsiasi pannello. Consultare <xref linkend="panels-addobject"/>. Fare clic sul pulsante <guibutton>Esegui</guibutton> per aprire il dialogo <guilabel>Esegui applicazione</guilabel>.</para></listitem></varlistentry><varlistentry><term>Usando i tasti scorciatoia</term><listitem><para>Premere <keycombo><keycap>Alt</keycap><keycap>F2</keycap></keycombo>. È possibile cambiare i tasti scorciatoia per mostrare il dialogo <guilabel>Esegui applicazione</guilabel> nello strumento di preferenze <link linkend="prefs-keyboard-shortcuts"><application>Scorciatoie da tastiera</application>.</link></para></listitem></varlistentry></variablelist></para>

<para>Viene mostrato il dialogo <guilabel>Esegui applicazione</guilabel>.</para>

</listitem>

<para>Inserire il comando che si vuole eseguire nel campo vuoto.</para>

<para>In alternativa, per scegliere un comando che si è eseguito in precedenza, fare clic sul pulsante freccia accanto al campo del comando, quindi scegliere in comando da eseguire.</para>

<para>In alternativa, selezionare l'opzione <guilabel>Mostra l'elenco delle applicazioni conosciute</guilabel> per mostrare un elenco delle applicazioni disponibili.</para>

<para>È anche possibile usare il pulsante <guibutton>Esegui con file</guibutton> per scegliere un file da accodare alla riga di comando. Ad esempio, è possibile inserire <application>emacs</application> come comando, quindi scegliere il file da editare.</para>

<para>Selezionare l'opzione <guilabel>Esegui nel terminare</guilabel> per eseguire l'applicazione o il comando in una finestra di terminale. Scegliere questa opzione per i comandi che non creano una finestra apposita per la loro esecuzione.</para>

</listitem>

<para>Fare clic sul pulsante <guibutton>Esegui</guibutton> nel dialogo <guilabel>Esegui applicazione</guilabel>.</para>

</listitem>

</orderedlist>

</section>

<title>Cattura di schermate</title>

<primary>schermate, catturare</primary>

</indexterm>

<para>È possibile catturare una schermata in uno dei modi seguenti:</para>

<para>Da qualsiasi pannello</para>

<para>È possibile aggiungere un pulsante <application>Cattura schermata</application> ad un qualsiasi pannello. Consultare <xref linkend="panels-addobject"/> per istruzioni su come fare ciò. Fare clic sul pulsante <guibutton>Cattura schermata</guibutton> per catturare un'istantanea dell'intero schermo.</para>

</listitem>

<para>Usando i tasti scorciatoia</para>

<para>Per catturare una schermata, usare i seguenti tasti scorciatoia:</para>

<thead>

<entry>

<para>Tasti scorciatoia predefiniti</para>

</entry>

<entry>

<para>Funzione</para>

</entry>

</row>

</thead>

<tbody>

<row>

<para>

<keycap>Stampa schermo</keycap>

</para>

</entry>

<para>Cattura un'istantanea dell'intero schermo.</para>

</entry>

</row>

<row>

<para><keycombo><keycap>Alt</keycap><keycap>Stampa schermo</keycap></keycombo></para>

</entry>

<para>Cattura un'istantanea della finestra a cui punta il mouse.</para>

</entry>

</row>

</tbody>

</tgroup>

</informaltable>

<para>È possibile usare lo strumento di preferenze <link linkend="prefs-keyboard-shortcuts"><application>Scorciatoie da tastiera</application></link> per modificare i tasti scorciatoia predefiniti.</para>

</listitem>

<para>Dalla barra dei menù</para>

<para>Scegliere <menuchoice><guimenu>Applicazioni</guimenu><guimenuitem>Accessori</guimenuitem><guimenuitem>Cattura schermata</guimenuitem></menuchoice>.</para>

</listitem>

<para>Dal terminale</para>

<para>È possibile usare il commando <command>gnome-panel-screenshot</command> per cattrurare una schermata. Il comando <command>gnome-panel-screenshot</command> cattura una schermata dell'intero schermo e mostra il dialogo <guilabel>Salvataggio schermata</guilabel>. Usare il dialogo <guilabel>Salvataggio schermata</guilabel> per salvare la schermata.</para>

<para>È anche possibile usare alcune opzioni assieme al comando <command>gnome-panel-screenshot</command>, come indicato di seguito:</para>

100

101

102

103

<thead>

104

105

<entry>

106

<para>Opzione</para>

107

</entry>

108

<entry>

109

<para>Funzione</para>

110

</entry>

111

</row>

112

</thead>

113

<tbody>

114

<row>

115

116

<para>

117

<command>--window</command>

118

</para>

119

</entry>

120

121

<para>Cattura un'istantanea della finestra che ha il focus.</para>

122

</entry>

123

</row>

124

<row>

125

126

<para>

127

<command>--delay=<replaceable>secondi</replaceable></command>

128

</para>

129

</entry>

130

131

<para>Cattura una schermata dopo il numero di secondi specificato e mostra il dialogo <guilabel>Salvataggio schermata</guilabel>. Usare il dialogo <guilabel>Salvataggio schermata</guilabel> per salvare la schermata.</para>

132

</entry>

133

</row>

134

<row>

135

136

<para>

137

138

</para>

139

</entry>

140

141

<para>Mostra le opzioni per il comando.</para>

142

</entry>

143

</row>

144

</tbody>

145

</tgroup>

146

</informaltable>

147

</listitem>

148

</itemizedlist>

149

150

<para>Quando si cattura un'istantanea, viene aperto il dialogo <guilabel>Salvataggio schermata</guilabel>. Per salvare la schermata come un file di immagine, inserire il nome di file per la schermata e scegliere una posizione nell'elenco a discesa.</para>

151

152

</section>

153

154

155

<title>Esploratore di documentazione Yelp</title>

156

157

158

</indexterm>

159

160

161

162

<title>Introduzione</title>

163

164

<para>The <application>Yelp Help Browser</application> application allows you to view documentation regarding GNOME and other components through a variety of formats. These formats include docbook files, HTML help pages, man pages and info pages (support for man pages and info pages may optionally be compiled in). Despite the different formats supported, Yelp does its best to provide a unified look and feel regardless of the original document format.</para>

165

166

<para><application>Yelp Help Browser</application> is internationalised, meaning that it has support to view documents in different languages. The documents must be localised or translated for each language and installed properly for Yelp Help Browser to be able to view them.</para>

167

</section>

168

169

170

171

172

<title>Starting Yelp</title>

173

174

175

<title>To Start <application>Yelp Help Browser</application></title>

176

177

<para>You can start <application>Yelp Help Browser</application> in the following ways:</para>

178

179

180

181

<term><guimenu>System</guimenu> Menu</term>

182

183

184

<para>Scegliere <application>Aiuto</application>.</para>

185

</listitem>

186

</varlistentry>

187

188

189

<term>Riga di comando</term>

190

191

192

<para>Eseguire il seguente comando: <command>yelp</command></para>

193

</listitem>

194

</varlistentry>

195

</variablelist></para>

196

</section>

197

198

199

<title>Interfaccia</title>

200

201

<para>When you start <application>Yelp Help Browser</application>, you will see the following window appear.</para>

202

203

<para><figure id="fig-yelp-window"><title><application>Yelp Help Browser</application> Window</title><mediaobject><imageobject><imagedata fileref="figures/yelp_window.png"/></imageobject></mediaobject></figure><application>Yelp Help Browser</application> contains the following elements in <xref linkend="fig-yelp-window"/></para>

204

205

206

207

<term><interface>Barra dei menu</interface></term>

208

209

210

211

212

213

214

215

<para>Use this menu to Open a New Window, view the About this Document page, Print the current document, or Close the window.</para>

216

</listitem>

217

</varlistentry>

218

219

220

<term><guimenu>Modifica</guimenu></term>

221

222

223

<para>Use this menu to Copy, Select all, Find..., or to set your Preferences.</para>

224

</listitem>

225

</varlistentry>

226

227

228

229

230

231

<para>Use this menu to navigate Back, Forward, to the Help Topics page. When viewing a DocBook document, use this menu to navigate to the Next Section, Previous Section or to the Contents.</para>

232

</listitem>

233

</varlistentry>

234

235

236

<term><guimenu>Bookmarks</guimenu></term>

237

238

239

<para>Use this menu to Add Bookmark(s), or Edit Bookmark(s).</para>

240

</listitem>

241

</varlistentry>

242

243

244

<term><guimenu>Aiuto</guimenu></term>

245

246

247

<para>View information about Yelp Help Browser and contributors to the project through the <guimenuitem>About</guimenuitem> menuitem. Open this document with the <guimenuitem>Contents</guimenuitem> menuitem or by pressing <keycap>F1</keycap>.</para>

248

</listitem>

249

</varlistentry>

250

</variablelist></para>

251

</listitem>

252

</varlistentry>

253

254

255

<term><interface>Barra degli strumenti</interface></term>

256

257

258

259

260

261

262

263

<para>Use this button to navigate back in your document history.</para>

264

</listitem>

265

</varlistentry>

266

267

268

<term><guibutton>Forward</guibutton></term>

269

270

271

<para>Use this button to navigate forward in your document history.</para>

272

</listitem>

273

</varlistentry>

274

275

276

<term><guibutton>Help Topics</guibutton></term>

277

278

279

<para>Use this button to return to the main table of contents (shown in <xref linkend="fig-yelp-window"/>)</para>

280

</listitem>

281

</varlistentry>

282

</variablelist></para>

283

</listitem>

284

</varlistentry>

285

286

287

<term><interface>Browser Pane</interface></term>

288

289

290

<para>The browser pane is where you will be presented with the table of contents or the documentation. Use the table of contents to navigate to the documentation you need.</para>

291

</listitem>

292

</varlistentry>

293

</variablelist>

294

</section>

295

</section>

296

297

298

299

300

<title>Using Yelp</title>

301

302

303

<title>Open a Document</title>

304

305

<para>To open a document in <application>Yelp Help Browser</application>, use the Table of Contents to navigate to the desired document</para>

306

307

<para>Alternatively, you may view a particular document by invoking Yelp Help Browser from the command line. Please see <xref linkend="yelp-advanced-cmdline"/>.</para>

308

</section>

309

310

311

<title>Open a New Window</title>

312

313

<para>To open a new window:</para>

314

315

316

317

<para>Click <menuchoice><guimenu>File</guimenu><guimenuitem>New Window</guimenuitem></menuchoice></para>

318

</listitem>

319

320

321

<para>Use the key combination <keycap>Ctrl</keycap>+<keycap>N</keycap></para>

322

</listitem>

323

</itemizedlist></para>

324

</section>

325

326

327

<title>About This Document</title>

328

329

<para>To view information about the currently open document:</para>

330

331

332

333

<para>Click <menuchoice><guimenu>File</guimenu><guimenuitem>About This Document</guimenuitem></menuchoice></para>

334

</listitem>

335

</itemizedlist><note>

336

<para>This option is only available for DocBook documentation. Legal notices and documentation contributors are usually listed in this section.</para>

337

</note></para>

338

</section>

339

340

341

<title>Print a Page</title>

342

343

<para>To print any page that you are able to view in <application>Yelp Help Browser</application>:</para>

344

345

346

347

<para>Click <menuchoice><guimenu>File</guimenu><guimenuitem>Print this Page</guimenuitem></menuchoice></para>

348

</listitem>

349

</itemizedlist></para>

350

</section>

351

352

353

<title>Print a Document</title>

354

355

<para>To print an entire document:</para>

356

357

358

359

<para>Click <menuchoice><guimenu>File</guimenu><guimenuitem>Print this Document</guimenuitem></menuchoice></para>

360

</listitem>

361

</itemizedlist><note>

362

<para>This option is only available for DocBook documentation.</para>

363

</note></para>

364

</section>

365

366

367

<title>Chiudere una finestra</title>

368

369

<para>To close a window in <application>Yelp Help Browser</application>, do the following:</para>

370

371

372

373

<para>Click <menuchoice><guimenu>File</guimenu><guimenuitem>Close Window</guimenuitem></menuchoice></para>

374

</listitem>

375

376

377

<para>Use the key combination <keycap>Ctrl</keycap>+<keycap>W</keycap></para>

378

</listitem>

379

</itemizedlist></para>

380

</section>

381

382

383

<title>Impostare le preferenze</title>

384

385

<para>To set your preferences in <application>Yelp Help Browser</application>:</para>

386

387

<para><itemizedlist><listitem><para>Click <menuchoice><guimenu>Edit</guimenu><guimenuitem>Preferences</guimenuitem></menuchoice></para></listitem></itemizedlist>A window will appear that looks like <xref linkend="yelp-preferences"/>:</para>

388

389

<para><figure id="yelp-preferences"><title><application>Yelp Help Browser</application> Preferences Window</title><mediaobject><imageobject><imagedata fileref="figures/yelp_preferences.png"/></imageobject></mediaobject></figure>The options that are available in this dialog have the following functions:</para>

390

391

392

393

<term><guilabel>Use system fonts</guilabel></term>

394

395

396

<para>Check this option to display documentation using the default fonts used by the GNOME Desktop.</para>

397

398

<para>To choose your own fonts to display documentation, uncheck this option and click on the buttons next to the text <guilabel>Variable Width</guilabel> or <guilabel>Fixed Width</guilabel>.</para>

399

400

401

402

<term><guilabel>Variable Width</guilabel></term>

403

404

405

<para>This is the font to use when a static or fixed width font is not required. The majority of text will be of this type.</para>

406

</listitem>

407

</varlistentry>

408

409

410

<term><guilabel>Fixed Width</guilabel></term>

411

412

413

<para>This is the font to use when all text characters need to be of the same size. This font is usually used to indicate commands, program blocks, or other text that falls under these categories.</para>

414

</listitem>

415

</varlistentry>

416

</variablelist></para>

417

</listitem>

418

</varlistentry>

419

420

421

<term><guilabel>Browse with caret</guilabel></term>

422

423

424

<para>Click this option if you would like see a caret or cursor in the <xref linkend="yelp-browser-pane"/>. This allows you to browse the document more easily by showing where the cursor is located in the document.</para>

425

</listitem>

426

</varlistentry>

427

</variablelist></para>

428

</section>

429

430

431

<title>Go Back in Document History</title>

432

433

<para>To go back in the document history:</para>

434

435

436

437

<para>Click <menuchoice><guimenu>Go</guimenu><guimenuitem>Back</guimenuitem></menuchoice></para>

438

</listitem>

439

440

441

<para>Use the key combination <keycap>Alt</keycap>+<keycap>Left</keycap></para>

442

</listitem>

443

444

445

<para>Use the <guibutton>Back</guibutton> button in the <interface>Toolbar</interface></para>

446

</listitem>

447

</itemizedlist></para>

448

</section>

449

450

451

<title>Go Forward in Document History</title>

452

453

<para>To go forward in the document history:</para>

454

455

456

457

<para>Click <menuchoice><guimenu>Go</guimenu><guimenuitem>Forward</guimenuitem></menuchoice></para>

458

</listitem>

459

460

461

<para>Use the key combination <keycap>Alt</keycap>+<keycap>Right</keycap></para>

462

</listitem>

463

464

465

<para>Use the <guibutton>Forward</guibutton> button in the <interface>Toolbar</interface></para>

466

</listitem>

467

</itemizedlist></para>

468

</section>

469

470

471

<title>Go to Help Topics</title>

472

473

<para>To go to the Help Topics:</para>

474

475

476

477

<para>Click <menuchoice><guimenu>Go</guimenu><guimenuitem>Help Topics</guimenuitem></menuchoice></para>

478

</listitem>

479

480

481

<para>Use the key combination <keycap>Alt</keycap>+<keycap>Home</keycap></para>

482

</listitem>

483

484

485

<para>Use the <guibutton>Help Topics</guibutton> button in the <interface>Toolbar</interface></para>

486

</listitem>

487

</itemizedlist></para>

488

</section>

489

490

491

<title>Go to Previous Section</title>

492

493

<para>To go to the previous section:</para>

494

495

496

497

<para>Click <menuchoice><guimenu>Go</guimenu><guimenuitem>Previous Section</guimenuitem></menuchoice></para>

498

</listitem>

499

500

501

<para>Use the key combination <keycap>Alt</keycap>+<keycap>Up</keycap></para>

502

</listitem>

503

</itemizedlist><note>

504

<para>This option is only available in DocBook formatted documents.</para>

505

</note></para>

506

</section>

507

508

509

<title>Go to Next Section</title>

510

511

<para>To go to the next section:</para>

512

513

514

515

<para>Click <menuchoice><guimenu>Go</guimenu><guimenuitem>Next Section</guimenuitem></menuchoice></para>

516

</listitem>

517

518

519

<para>Use the key combination <keycap>Alt</keycap>+<keycap>Down</keycap></para>

520

</listitem>

521

</itemizedlist><note>

522

<para>This option is only available in DocBook formatted documents.</para>

523

</note></para>

524

</section>

525

526

527

<title>Go to Contents</title>

528

529

<para>To go to the contents for a document:</para>

530

531

532

533

<para>Click <menuchoice><guimenu>Go</guimenu><guimenuitem>Contents</guimenuitem></menuchoice></para>

534

</listitem>

535

</itemizedlist><note>

536

<para>This option is only available in DocBook formatted documents.</para>

537

</note></para>

538

</section>

539

540

541

<title>Aggiungere un segnalibro</title>

542

543

<para>To add a bookmark for a particular document:</para>

544

545

<para><itemizedlist><listitem><para>Click <menuchoice><guimenu>Bookmarks</guimenu><guimenuitem>Add Bookmark</guimenuitem></menuchoice></para></listitem><listitem><para>Use the key combination <keycap>Ctrl</keycap>+<keycap>D</keycap></para></listitem></itemizedlist>A window will appear that looks like <xref linkend="yelp-add-bookmark"/>.</para>

546

547

<para><figure id="yelp-add-bookmark"><title>Add Bookmark Window</title><mediaobject><imageobject><imagedata fileref="figures/yelp_add_bookmark.png"/></imageobject></mediaobject></figure>Enter your desired bookmark title in to the <guilabel>Title</guilabel> text entry field. Then click <guibutton>Add</guibutton> to add the bookmark, or click <guibutton>Cancel</guibutton> to cancel the request.</para>

548

</section>

549

550

551

<title>Edit Bookmarks</title>

552

553

<para>To edit your collection of bookmarkst:</para>

554

555

<para><itemizedlist><listitem><para>Click <menuchoice><guimenu>Bookmarks</guimenu><guimenuitem>Edit Bookmarks...</guimenuitem></menuchoice></para></listitem><listitem><para>Use the key combination <keycap>Ctrl</keycap>+<keycap>B</keycap></para></listitem></itemizedlist>A window will appear that looks like <xref linkend="yelp-edit-bookmarks"/>.</para>

556

557

<para><figure id="yelp-edit-bookmarks"><title>Edit Bookmarks Window</title><mediaobject><imageobject><imagedata fileref="figures/yelp_edit_bookmarks.png"/></imageobject></mediaobject></figure>You can manage your bookmarks using this window in the following ways:</para>

558

559

<para><variablelist><varlistentry><term><guibutton>Apri</guibutton></term><listitem><para>Use this button to open the selected bookmark in a new window.</para></listitem></varlistentry><varlistentry><term><guibutton>Rinomina</guibutton></term><listitem><para>Use this button to rename the title of your bookmark.</para></listitem></varlistentry><varlistentry><term><guibutton>Remove</guibutton></term><listitem><para>Use this button to delete the bookmark from your collection.</para></listitem></varlistentry></variablelist>Once you are finished managing your bookmarks, click the <guibutton>Close</guibutton> button to exit the <interface>Edit Bookmarks Window</interface>.</para>

560

</section>

561

562

563

564

565

<para>To get help using <application>Yelp Help Browser</application> (and see this document):</para>

566

567

568

569

<para>Click <menuchoice><guimenu>Help</guimenu><guimenuitem>Contents</guimenuitem></menuchoice></para>

570

</listitem>

571

</itemizedlist></para>

572

</section>

573

</section>

574

575

576

577

578

<title>Advanced Features</title>

579

580

581

<title>Using the Command Line to Open Documents</title>

582

583

<para>Yelp Help Browser supports opening documents from the command line. There are a number of URIs (Uniform Resource Identifiers) that can be used. These include:</para>

584

585

586

587

588

589

590

<para>Use this URI when you want to access a file with yelp, for example:</para>

591

592

<screen><userinput>yelp file:///usr/share/gnome/help/gcalctool/C/gcalctool.xml</userinput></screen>

593

594

</listitem>

595

</varlistentry>

596

597

598

<term><option>ghelp:</option> or <option>gnome-help:</option></term>

599

600

601

<para>Use this URI when you want to access GNOME help documents, which are typically written in DocBook format.</para>

602

603

<screen><userinput>yelp ghelp:gcalctool</userinput></screen>

604

605

<para>If you want to open the help document at a particular section, append a question mark to the end of the URI, followed by the section id.</para>

606

607

<screen><userinput>yelp ghelp:user-guide?yelp-advanced-cmdline</userinput></screen>

608

</listitem>

609

</varlistentry>

610

611

612

613

614

615

<para>Use this URI when you want to access a particular man page. You can append the section of the man page you would like to view if there are multiple man pages with the same name. The section number should be enclosed in parenthesis and therefore it may be necessary to escape the argument so that the shell does not interpret the parenthesis.</para>

616

617

<screen><userinput>yelp man:gcalctool</userinput></screen>

618

619

620

621

<screen><userinput>yelp 'man:intro(1)'</userinput>

622

<userinput>yelp 'man:intro(2)'</userinput></screen>

623

</listitem>

624

</varlistentry>

625

626

627

628

629

630

<para>Use this URI when you want to access a particular GNU info page.</para>

631

632

633

</listitem>

634

</varlistentry>

635

</variablelist>

636

</section>

637

638

639

<title>Refreshing Content on Demand</title>

640

641

<para><application>Yelp Help Browser</application> supports the <keycombo><keycap>Ctrl</keycap><keycap>R</keycap></keycombo> shortcut keys, which will reload the DocBook document that is currently open. This allows developers to view changes to documents as they are made.</para>

642

</section>

643

</section>

644

645

646

<title>More Information</title>

647

648

<para>This section details some of the helper applications which <application>Yelp Help Browser</application> uses, and provides resources where you can get more information about <application>Yelp Help Browser</application>.</para>

649

650

651

<title>Scrollkeeper</title>

652

653

<para><application>Yelp Help Browser</application> uses scrollkeeper to generate the table of contents for DocBook and HTML documentation, and also keep track of translations for each document.</para>

654

</section>

655

656

657

<title>GNOME Documentation Utilites</title>

658

659

<para>The documentation distributed with GNOME uses this set of utilities for a variety of things:</para>

660

661

<para><itemizedlist><listitem><para>Ease translation of documents to different languages.</para></listitem><listitem><para>Provide a set of tools to help package and install documentation into the correct location and register the documentation with scrollkeeper.</para></listitem><listitem><para>Perform conversion from DocBook format to a format suitable for display.</para></listitem></itemizedlist><application>Yelp Help Browser</application> relies on <ulink url="ghelp:gnome-doc-xslt">GNOME XSLT Stylesheets</ulink> to perform conversion from DocBook to HTML. <ulink url="ghelp:gnome-doc-make">GNOME Documentation Build Utilities</ulink> are relied upon by application authors to install and register documentation within the help system.</para>

662

</section>

663

664

665

<title>Mailing List</title>

666

667

<para>For further information on <application>Yelp Help Browser</application> please subscribe to the mailing list, <ulink type="http" url="http://mail.gnome.org/mailman/listinfo/gnome-doc-devel-list">gnome-doc-devel-list@gnome.org</ulink>.</para>

668

</section>

669

</section>

670

671

672

<title>Joining the GNOME Documentation Project</title>

673

674

<para>If you are interesting in helping produce and update documentation for the GNOME project, please visit the following link: <ulink url="http://live.gnome.org/DocumentationProject">http://live.gnome.org/DocumentationProject</ulink></para>

675

</section>

676

677

</section>

678

679

</chapter>

Older »