| | | |
Offset 379, 21 lines modified | Offset 379, 21 lines modified |
379 | .PP | 379 | .PP |
380 | *·and·the·status·bar·on·the·bottom | 380 | *·and·the·status·bar·on·the·bottom |
381 | .PP | 381 | .PP |
382 | ###·Navigation·bar | 382 | ###·Navigation·bar |
383 | .PP | 383 | .PP |
384 | In·the·navigation·bar,·you·have·some·buttons·and·your·URL·bar. | 384 | In·the·navigation·bar,·you·have·some·buttons·and·your·URL·bar. |
385 | .PP | 385 | .PP |
386 | You·can·enter·any·supported·URL·in·the·URL·bar,·press·.IReturn.R·and·Kristall·will·then·load·the·page·in·the·content·view.·You·usually·need·to·specify·the·url·scheme·to·navigate·to·a·specific·site,·but·you·can·omit·the·gemini://·prefix·for·gemini·pages.·If·you·enter·a·URL·with·no·scheme,·and·it·looks·like·a·U[·...·truncated·by·diffoscope;·len:·130,·SHA:·ec0932d3f52e59be67b00eba96c8d5977c86c3833c75b800ab2df647484986dd·...·]R·look·like·a·URL·(e.g·"i·like·dogs"),·it·will·be·assumed·a·search·query,·and·will·be·forwarded·to·the·search·engine·that·is·set·in·the·Settings. | 386 | You·can·enter·any·supported·URL·in·the·URL·bar,·press·\fIReturn\fR·and·Kristall·will·then·load·the·page·in·the·content·view.·You·usually·need·to·specify·the·url·scheme·to·navigate·to·a·specific·site,·but·you·can·omit·the·gemini://·prefix·for·gemini·pages.·If·you·enter·a·URL·with·no·scheme,·and·it·looks·like·a[·...·truncated·by·diffoscope;·len:·134,·SHA:·61d6944876ac244fbb6ea4fc2cc4bb3a9c84b031b49d05c150bf171086a18953·...·]R·look·like·a·URL·(e.g·"i·like·dogs"),·it·will·be·assumed·a·search·query,·and·will·be·forwarded·to·the·search·engine·that·is·set·in·the·Settings. |
387 | .PP | 387 | .PP |
388 | The·two·buttons·on·the·left·of·the·navigation·bar·that·give·you·the·ability·to·navigate·back·and·forth·in·your·browsing·history.·The·button·with·the·round·arrow·is·the·refresh·button·and·allows·you·to·reload·the·currently·displayed·site.·While·a·site·is·loading,·it·is·replaced·with·the·stop·button·(square·icon)·that·allows·you·to·cancel·the·current·request.·Tip:·Some·additional·buttons·can·also·be·enabled·in·the·settings,·to·quickly·navigate·to·the·home·page,·and·even·the·'root'·and·'parent'·of·the·current·URL!·(See·.BAdditional·Toolbar·Items.R·in·Settings) | 388 | The·two·buttons·on·the·left·of·the·navigation·bar·that·give·you·the·ability·to·navigate·back·and·forth·in·your·browsing·history.·The·button·with·the·round·arrow·is·the·refresh·button·and·allows·you·to·reload·the·currently·displayed·site.·While·a·site·is·loading,·it·is·replaced·with·the·stop·button·(square·icon)·that·allows·you·to·cancel·the·current·request.·Tip:·Some·additional·buttons·can·also·be·enabled·in·the·settings,·to·quickly·navigate·to·the·home·page,·and·even·the·'root'·and·'parent'·of·the·current·URL!·(See·\fBAdditional·Toolbar·Items\fR·in·Settings) |
389 | .PP | 389 | .PP |
390 | On·the·right·side·of·the·URL·bar·you·will·find·two·buttons: | 390 | On·the·right·side·of·the·URL·bar·you·will·find·two·buttons: |
391 | .PP | 391 | .PP |
392 | *·The·button·with·the·small·heart·icon·in·it·will·add·or·remove·this·page·to·your·favourites,·this·can·be·done·as·well·by·pressing·.ICtrl-D.R.·When·the·heart·on·the·button·is·filled,·the·site·is·contained·in·your·favourites.·If·not,·the·heart·has·only·a·outline·display.·Clicking·this·button·will·open·a·small·menu·to·allow·you·to·quickly·place·the·favourite·in·a·folder·of·your·choosing[·...·truncated·by·diffoscope;·len:·49,·SHA:·d2a8395276001c57e1f979825784bdf622e294e01c316d5625f2d1a93be6d7f9·...·]R·in·this·menu·to·quickly·affirm·the·options·displayed·in·it. | 392 | *·The·button·with·the·small·heart·icon·in·it·will·add·or·remove·this·page·to·your·favourites,·this·can·be·done·as·well·by·pressing·\fICtrl-D\fR.·When·the·heart·on·the·button·is·filled,·the·site·is·contained·in·your·favourites.·If·not,·the·heart·has·only·a·outline·display.·Clicking·this·button·will·open·a·small·menu·to·allow·you·to·quickly·place·the·favourite·in·a·folder·of·your·choosi[·...·truncated·by·diffoscope;·len:·53,·SHA:·faa4d2b25387b23e955bdd5633a522d71a73a72bd2c45521c78f6984a42a2f27·...·]R·in·this·menu·to·quickly·affirm·the·options·displayed·in·it. |
393 | .PP | 393 | .PP |
394 | *·The·button·with·the·shield·icon·toggles·the·use·of·client·certificates.·Pressing·it·when·no·client·certificate·is·enabled,·a·dialog·will·pop·up·asking·you·to·select·or·create·a·certificate.·When·a·certificate·is·enabled,·the·button·will·have·a·filled·shield·with·a·small·lock·in·it.·Pressing·the·button·now·will·disable·the·currently·used·certificate.·Note·that·if·you're·using·a·transient·certificate,·Kristall·will·ask·you·a·safety·question·before·destroying·the·certificate. | 394 | *·The·button·with·the·shield·icon·toggles·the·use·of·client·certificates.·Pressing·it·when·no·client·certificate·is·enabled,·a·dialog·will·pop·up·asking·you·to·select·or·create·a·certificate.·When·a·certificate·is·enabled,·the·button·will·have·a·filled·shield·with·a·small·lock·in·it.·Pressing·the·button·now·will·disable·the·currently·used·certificate.·Note·that·if·you're·using·a·transient·certificate,·Kristall·will·ask·you·a·safety·question·before·destroying·the·certificate. |
395 | .PP | 395 | .PP |
396 | ###·Content·view | 396 | ###·Content·view |
397 | .PP | 397 | .PP |
398 | The·content·view·renders·the·requested·document.·For·hypertext·documents·(i.e·gemtext,·markdown,·etc),·you·get·a·nicely·rendered·version·of·those·documents,·other·text·files·are·displayed·in·monospace.·Audio·and·video·files·are·played·in·a·small·built-in·media·player·that·allows·you·to·play/pause·the·media,·scroll·around·in·the·time·line·and·mute/unmute·audio.·Images·are·rendered·in·an·interactive·view·where·you·can·drag·the·image·around·and·zoom·in/out·with·the·mouse·wheel. | 398 | The·content·view·renders·the·requested·document.·For·hypertext·documents·(i.e·gemtext,·markdown,·etc),·you·get·a·nicely·rendered·version·of·those·documents,·other·text·files·are·displayed·in·monospace.·Audio·and·video·files·are·played·in·a·small·built-in·media·player·that·allows·you·to·play/pause·the·media,·scroll·around·in·the·time·line·and·mute/unmute·audio.·Images·are·rendered·in·an·interactive·view·where·you·can·drag·the·image·around·and·zoom·in/out·with·the·mouse·wheel. |
399 | .PP | 399 | .PP |
Offset 409, 331 lines modified | Offset 409, 331 lines modified |
409 | .PP | 409 | .PP |
410 | ##·Menus | 410 | ##·Menus |
411 | .PP | 411 | .PP |
412 | This·chapter·explains·what·each·menu·button·does.·I·hope·that·most·stuff·isn't·surprising·😉 | 412 | This·chapter·explains·what·each·menu·button·does.·I·hope·that·most·stuff·isn't·surprising·😉 |
413 | .PP | 413 | .PP |
414 | ###·File | 414 | ###·File |
415 | .PP | 415 | .PP |
416 | .BNew·Tab.R·will·open·a·new·tab·to·surf. | 416 | \fBNew·Tab\fR·will·open·a·new·tab·to·surf. |
417 | .PP | 417 | .PP |
418 | .BNew·Window.R·will·open·a·new·window·to·browse·in. | 418 | \fBNew·Window\fR·will·open·a·new·window·to·browse·in. |
419 | .PP | 419 | .PP |
420 | .BSave·as.R·allows·you·to·save·the·currently·displayed·file·to·your·disk. | 420 | \fBSave·as\fR·allows·you·to·save·the·currently·displayed·file·to·your·disk. |
421 | .PP | 421 | .PP |
422 | .BClose·Tab.R·will·close·the·current·tab.·Does·the·same·as·clicking·the·small·(×)·button·on·the·tab·itself. | 422 | \fBClose·Tab\fR·will·close·the·current·tab.·Does·the·same·as·clicking·the·small·(×)·button·on·the·tab·itself. |
423 | .PP | 423 | .PP |
424 | .BManage·Certificates.R·will·bring·up·a·dialog·that·allows·you·to·create,·delete·or·change·client·certificates. | 424 | \fBManage·Certificates\fR·will·bring·up·a·dialog·that·allows·you·to·create,·delete·or·change·client·certificates. |
425 | .PP | 425 | .PP |
426 | .BSettings.R·will·open·a·dialog·that·helps·you·configure·Kristall·to·your·likings. | 426 | \fBSettings\fR·will·open·a·dialog·that·helps·you·configure·Kristall·to·your·likings. |
427 | .PP | 427 | .PP |
428 | .BQuit.R·will·close·Kristall. | 428 | \fBQuit\fR·will·close·Kristall. |
429 | .PP | 429 | .PP |
430 | ###·Navigation | 430 | ###·Navigation |
431 | .PP | 431 | .PP |
432 | This·menu·contains·means·to·navigate·the·internet. | 432 | This·menu·contains·means·to·navigate·the·internet. |
433 | .PP | 433 | .PP |
434 | .BGo·to·home.R·will·navigate·your·current·tab·to·your·home·page. | 434 | \fBGo·to·home\fR·will·navigate·your·current·tab·to·your·home·page. |
435 | .PP | 435 | .PP |
436 | .BBackward.R·will·navigate·one·page·back·in·your·history. | 436 | \fBBackward\fR·will·navigate·one·page·back·in·your·history. |
437 | .PP | 437 | .PP |
438 | .BForeward.R·will·navigate·one·page·foreward·in·your·history. | 438 | \fBForeward\fR·will·navigate·one·page·foreward·in·your·history. |
439 | .PP | 439 | .PP |
440 | .BRoot.R·will·take·you·to·the·root·directory·of·the·current·site.·e.g·if·you·are·currently·at·gemini://example.com/gemlog/some-document.gmi,·you·will·be·taken·to·gemini://example.com/ | 440 | \fBRoot\fR·will·take·you·to·the·root·directory·of·the·current·site.·e.g·if·you·are·currently·at·gemini://example.com/gemlog/some-document.gmi,·you·will·be·taken·to·gemini://example.com/ |
441 | .PP | 441 | .PP |
442 | .BParent.R·will·take·you·to·the·'parent'·directory·of·the·current·site.·e.g·if·you·are·at·gemini://example.com/parent/some-document.gmi,·you·will·be·taken·to·gemini://example.com/parent/ | 442 | \fBParent\fR·will·take·you·to·the·'parent'·directory·of·the·current·site.·e.g·if·you·are·at·gemini://example.com/parent/some-document.gmi,·you·will·be·taken·to·gemini://example.com/parent/ |
443 | .PP | 443 | .PP |
444 | .BRefresh.R·will·reload·the·current·page.·This·may·be·necessary·for·CGI·scripts·or·other·interactive·content. | 444 | \fBRefresh\fR·will·reload·the·current·page.·This·may·be·necessary·for·CGI·scripts·or·other·interactive·content. |
445 | .PP | 445 | .PP |
446 | .BAdd·to·favourites.R·will·add·or·remove·the·current·page·to/from·your·list·of·favourites. | 446 | \fBAdd·to·favourites\fR·will·add·or·remove·the·current·page·to/from·your·list·of·favourites. |
447 | .PP | 447 | .PP |
448 | ###·View | 448 | ###·View |
449 | .PP | 449 | .PP |
450 | This·menu·allows·you·to·show/hide·dockable·dialogs. | 450 | This·menu·allows·you·to·show/hide·dockable·dialogs. |
451 | .PP | 451 | .PP |
452 | .BDocument·Outline.R·toggles·the·document·outline.·Documents·with·text/gemini·get·an·automatic·outline·generation·that·can·be·used·to·navigate·larger·documents·quicker.·If·you're·reading·this·help·document·inside·of·Kristall,·this·is·a·good·place·to·try·this·feature·out! | 452 | \fBDocument·Outline\fR·toggles·the·document·outline.·Documents·with·text/gemini·get·an·automatic·outline·generation·that·can·be·used·to·navigate·larger·documents·quicker.·If·you're·reading·this·help·document·inside·of·Kristall,·this·is·a·good·place·to·try·this·feature·out! |
453 | .PP | 453 | .PP |
454 | .BFavourites.R·opens·a·dock·containing·a·list·of·all·your·favourite·(a.k.a·bookmarked)·sites.·Open·your·favourites·into·a·new·tab·by·double-clicking·or·pressing·.IReturn.R·on·the·entries.·If·you·right·click·on·an·entry·you·will·be·presented·with·a·menu·in·which·you·can·edit·the·name·or·location·of·the·entry,·or·delete·it.·Right-clicking·in·the·window·(not·on·an·entry,·not·on·a·group)·will·allow·you·to·create·a·new·"group"·of·entries.·Right·clicking·on·a·group·will·allow·you·to·rename·the·group,·or·recursively·delete·it·(be·careful!). | 454 | \fBFavourites\fR·opens·a·dock·containing·a·list·of·all·your·favourite·(a.k.a·bookmarked)·sites.·Open·your·favourites·into·a·new·tab·by·double-clicking·or·pressing·\fIReturn\fR·on·the·entries.·If·you·right·click·on·an·entry·you·will·be·presented·with·a·menu·in·which·you·can·edit·the·name·or·location·of·the·entry,·or·delete·it.·Right-clicking·in·the·window·(not·on·an·entry,·not·on·a·group)·will·allow·you·to·create·a·new·"group"·of·entries.·Right·clicking·on·a·group·will·allow·you·to·rename·the·group,·or·recursively·delete·it·(be·careful!). |
455 | .PP | 455 | .PP |
456 | .BHistory.R·shows·the·surfing·history·of·the·current·tab.·Double-clicking·an·entry·navigates·back·and·forth·in·your·history·without·disturbing·the·list. | 456 | \fBHistory\fR·shows·the·surfing·history·of·the·current·tab.·Double-clicking·an·entry·navigates·back·and·forth·in·your·history·without·disturbing·the·list. |
457 | .PP | 457 | .PP |
458 | ###·Help | 458 | ###·Help |
459 | .PP | 459 | .PP |
460 | This·menu·contains·some·stuff·that·provides·help·or·information·about·Kristall. | 460 | This·menu·contains·some·stuff·that·provides·help·or·information·about·Kristall. |
461 | .PP | 461 | .PP |
462 | .BHelp.R·displays·the·help·manual·(this·document). | 462 | \fBHelp\fR·displays·the·help·manual·(this·document). |
463 | .PP | 463 | .PP |
464 | .BChangelog.R·will·open·a·document·that·lists·the·changes·in·Kristall·in·a·bulleted·list. | 464 | \fBChangelog\fR·will·open·a·document·that·lists·the·changes·in·Kristall·in·a·bulleted·list. |
465 | .PP | 465 | .PP |
466 | .BAbout.R·shows·a·dialog·with·some·information·about·Kristall. | 466 | \fBAbout\fR·shows·a·dialog·with·some·information·about·Kristall. |
467 | .PP | 467 | .PP |
468 | .BAbout·Qt.R·shows·a·dialog·containing·legal·information·about·the·Qt·version·used. | 468 | \fBAbout·Qt\fR·shows·a·dialog·containing·legal·information·about·the·Qt·version·used. |
469 | .PP | 469 | .PP |
470 | ##·Settings | 470 | ##·Settings |
471 | .PP | 471 | .PP |
472 | Kristall·offers·a·vast·amount·of·settings.·You·can·style·the·documents·to·your·liking,·changing·fonts·and·colors.·You·can·also·fine-tune·the·behaviour·of·Kristall·to·match·your·likings·and·keep·track·of·your·trusted·pages.·Please·note·that·Kristall·has·been·designed·mostly·for·browsing·geminispace,·thus·many·of·these·settings·are·specific·or·exclusive·to·Gemini·only. | 472 | Kristall·offers·a·vast·amount·of·settings.·You·can·style·the·documents·to·your·liking,·changing·fonts·and·colors.·You·can·also·fine-tune·the·behaviour·of·Kristall·to·match·your·likings·and·keep·track·of·your·trusted·pages.·Please·note·that·Kristall·has·been·designed·mostly·for·browsing·geminispace,·thus·many·of·these·settings·are·specific·or·exclusive·to·Gemini·only. |
473 | .PP | 473 | .PP |
474 | ###·Generic | 474 | ###·Generic |
475 | .PP | 475 | .PP |
476 | This·tab·contains·an·unsorted·list·of·settings·that·allow·you·to·tweak·Kristalls·behaviour. | 476 | This·tab·contains·an·unsorted·list·of·settings·that·allow·you·to·tweak·Kristalls·behaviour. |
477 | .PP | 477 | .PP |
478 | .BStart·Page.R·is·the·URL·to·the·page·that·will·be·loaded·for·new·tabs·and·windows.·Default·is·.Babout:favourites.R. | 478 | \fBStart·Page\fR·is·the·URL·to·the·page·that·will·be·loaded·for·new·tabs·and·windows.·Default·is·\fBabout:favourites\fR. |
479 | .PP | 479 | .PP |
480 | .BSearch·Engine.R·is·the·search·engine·to·use·when·typing·non-URLs·in·the·URL·bar.·A·handful·of·Gemini·search·engines·are·provided·as·a·drop-down.·If·you·would·like·to·specify·your·own,·specify·it·in·a·format·similar·to·the·following: | 480 | \fBSearch·Engine\fR·is·the·search·engine·to·use·when·typing·non-URLs·in·the·URL·bar.·A·handful·of·Gemini·search·engines·are·provided·as·a·drop-down.·If·you·would·like·to·specify·your·own,·specify·it·in·a·format·similar·to·the·following: |
481 | .RS | 481 | .RS |
482 | .PP | 482 | .PP |
483 | gemini://example.com/search?%1 | 483 | gemini://example.com/search?%1 |
484 | .RE | 484 | .RE |
485 | .PP | 485 | .PP |
486 | Note·the·"%1"·at·the·end·of·the·URL.·This·is·where·search·queries·will·be·inserted.·This·.Imust.R·be·provided·in·order·for·Kristall·to·work·with·the·search·engine·correctly.·Be·aware·that·search·engine·URLs·can·vary.·For·example,·a·different·search·engine·may·appear·like·so: | 486 | Note·the·"%1"·at·the·end·of·the·URL.·This·is·where·search·queries·will·be·inserted.·This·\fImust\fR·be·provided·in·order·for·Kristall·to·work·with·the·search·engine·correctly.·Be·aware·that·search·engine·URLs·can·vary.·For·example,·a·different·search·engine·may·appear·like·so: |
487 | .RS | 487 | .RS |
488 | .PP | 488 | .PP |
489 | gemini://example2.com/search/another/%1 | 489 | gemini://example2.com/search/another/%1 |
490 | .RE | 490 | .RE |
491 | .PP | 491 | .PP |
492 | .BAdditional·Toolbar·Items.R·contains·various·additional·toolbar·items·which·some·may·find·useful. | 492 | \fBAdditional·Toolbar·Items\fR·contains·various·additional·toolbar·items·which·some·may·find·useful. |
493 | .PP | 493 | .PP |
494 | *·.BHome.R·button·opens·the·configured·home·page·in·the·current·tab. | 494 | *·\fBHome\fR·button·opens·the·configured·home·page·in·the·current·tab. |
495 | .PP | 495 | .PP |
496 | *·.BNew·tab.R·button·appears·to·the·right·of·the·tab·bar.·This·simply·adds·a·new·tab·to·the·current·window. | 496 | *·\fBNew·tab\fR·button·appears·to·the·right·of·the·tab·bar.·This·simply·adds·a·new·tab·to·the·current·window. |
497 | .PP | 497 | .PP |
498 | *·.BRoot.R·button·takes·you·to·the·root·directory·of·the·current·site.·(See·Menus>Navigation·section·for·explanation·of·what·this·does). | 498 | *·\fBRoot\fR·button·takes·you·to·the·root·directory·of·the·current·site.·(See·Menus>Navigation·section·for·explanation·of·what·this·does). |
499 | .PP | 499 | .PP |
500 | *·.BParent.R·button·takes·you·to·the·parent·directory·of·the·current·site.·(See·Menus>Navigation·section·for·explanation·of·what·this·does). | 500 | *·\fBParent\fR·button·takes·you·to·the·parent·directory·of·the·current·site.·(See·Menus>Navigation·section·for·explanation·of·what·this·does). |
501 | .PP | 501 | .PP |
502 | .BUI·Theme.R·controls·whether·the·Qt·interface·is·displayed·in·a·dark·or·a·light·theme.·Selecting·.BLight.R·or·.BDark.R·will·use·the·provided·Qt·light/dark·themes.·.BOS·Default.R·will·use·your·system·theme. | 502 | \fBUI·Theme\fR·controls·whether·the·Qt·interface·is·displayed·in·a·dark·or·a·light·theme.·Selecting·\fBLight\fR·or·\fBDark\fR·will·use·the·provided·Qt·light/dark·themes.·\fBOS·Default\fR·will·use·your·system·theme. |
503 | .PP | 503 | .PP |
504 | .BIcon·Theme.R·controls·the·specific·icon·set·that·the·Qt·interface·will·use.·Usually,·the·default·.BAuto.R·option·should·be·good·enough,·however·for·those·using·the·.BOS·Default.R·UI·theme,·this·option·may·be·useful. | 504 | \fBIcon·Theme\fR·controls·the·specific·icon·set·that·the·Qt·interface·will·use.·Usually,·the·default·\fBAuto\fR·option·should·be·good·enough,·however·for·those·using·the·\fBOS·Default\fR·UI·theme,·this·option·may·be·useful. |
505 | .PP | 505 | .PP |
506 | .BUI·Density.R·controls·the·margin·of·the·toolbar·buttons. | 506 | \fBUI·Density\fR·controls·the·margin·of·the·toolbar·buttons. |
507 | .PP | 507 | .PP |
508 | *·.BCompact.R·has·a·very·low·margin | 508 | *·\fBCompact\fR·has·a·very·low·margin |
509 | .PP | 509 | .PP |
510 | *·.BClassic.R·has·the·original·big·margin | 510 | *·\fBClassic\fR·has·the·original·big·margin |
511 | .PP | 511 | .PP |
512 | .BEnabled·Protocols.R·allows·you·to·fine-tune·which·protocols·are·fetched·by·Kristall.·By·default,·only·Gemini·is·enabled,·all·other·protocols·are·disabled.·Disabled·protocols·are·either·not·served,·and·produce·an·error·message,·or·are·forwarded·to·your·OS·handler·for·that·URL·scheme. | 512 | \fBEnabled·Protocols\fR·allows·you·to·fine-tune·which·protocols·are·fetched·by·Kristall.·By·default,·only·Gemini·is·enabled,·all·other·protocols·are·disabled.·Disabled·protocols·are·either·not·served,·and·produce·an·error·message,·or·are·forwarded·to·your·OS·handler·for·that·URL·scheme. |
513 | .PP | 513 | .PP |
Max diff block lines reached; 37988/53494 bytes (71.01%) of diff not shown.
|