Page Location: /help/
Page FileName: content/help/page.md
Jump to Formatted Article Close Page Source View
---
Title: Help
TitleNavigation: Help
Published: 2024-04-21
Author: John
AuthorChildren: John
Layout: default
LayoutNew: items
LayoutChildren: item
---

[--more--]

[selectpages start=auto
	orderby='published' order=descend 	
	template=default-SummaryItems excerpts=true
	paginate=true count=3]

Jump to Top Page Source Close Page Source View

1969 Dec 31

Hur man anpassar en layout

Så här anpassar du en layout på din webbplats.

Anpassa HTML

För att anpassa HTML-koden på din webbplats ändrar man layouten. Låt oss se hur layouter görs. Standardlayouten definieras i systeminställningarna. En annan layout kan definieras i sidinställningarna högst upp på varje sida, till exempel Layout: default.

Här är en exempelfil system/layouts/default.html:

<?php $this->yellow->layout("header") ?>
<div class="content">
<div class="main" role="main">
<h1><?php echo $this->yellow->page->getHtml("titleContent") ?></h1>
<?php echo $this->yellow->page->getContentHtml() ?>
</div>
</div>
<?php $this->yellow->layout("footer") ?>

Här är en exempellayout för att visa sidinnehåll och ytterligare HTML-kod:

<?php $this->yellow->layout("header") ?>
<div class="content">
<div class="main" role="main">
<h1><?php echo $this->yellow->page->getHtml("titleContent") ?></h1>
<?php echo $this->yellow->page->getContentHtml() ?>
<p>Hello world</p>
</div>
</div>
<?php $this->yellow->layout("footer") ?>

Här är en exempellayout för att visa sidinnehåll och ytterligare bloggsidor:

<?php $this->yellow->layout("header") ?>
<div class="content">
<div class="main" role="main">
<h1><?php echo $this->yellow->page->getHtml("titleContent") ?></h1>
<?php echo $this->yellow->page->getContentHtml() ?>
<?php $pages = $this->yellow->content->index()->filter("layout", "blog")->sort("published", false)->limit(5) ?>
<?php $this->yellow->page->setLastModified($pages->getModified()) ?>
<?php $this->yellow->page->setHeader("Cache-Control", "max-age=60") ?>
<table>
<?php foreach ($pages as $page): ?>
<tr>
<td><a href="<?php echo $page->getLocation(true) ?>"><?php echo $page->getHtml("title") ?></a></td>
<td><?php echo $page->getHtml("author") ?></td>
<td><?php echo $page->getDateHtml("published") ?></td>
</tr>
<?php endforeach ?>
</table>
</div>
</div>
<?php $this->yellow->layout("footer") ?>

Teman kan ha sina egna layoutfiler för att skriva över den befintliga layouten. Lägg till ett tema i filnamnet. Till exempel kommer filen system/layouts/default.html att användas med vilket tema som helst, filen system/layouts/stockholm-default.html kommer bara att användas med Theme: stockholm.

Har du några frågor? Få hjälp.

1969 Dec 31

Hur man anpassar ett språk

Så här anpassar du ett språk på din webbplats.

Anpassa språkinställningar

För att anpassa språket på din webbplats ändrar man språkinställningar. Språkinställningarna innehåller inställningarna för alla installerade tillägg. Du kan också lägga till dina egna språkinställningar i konfigurationsfilen, till exempel bildtexter.

Enkelspråkigt läge

Standardspråket definieras systeminställningarna. Ett annat språk kan definieras i sidinställningarna högst upp på varje sida, till exempel Language: en.

En engelsk sida:

---
Title: About
Language: en
---
Birds of a feather flock together.

En tysk sida:

---
Title: Über
Language: de
---
Wo zusammenwächst was zusammen gehört.

En svensk sida:

---
Title: Om
Language: sv
---
Lika barn leka bäst.

Flerspråkigt läge

För flerspråkiga webbplatser kan du använda flerspråkigt läge. Till exempel om du översätter en hel webbplats. Öppna filen system/extensions/yellow-system.ini och ändra CoreMultiLanguageMode: 1. Gå till din innehållsmapp och skapa en ny mapp för varje språk. Här är ett exempel:

├── content               
│   ├── 1-en              
│   │   ├── 1-home        = http://website/
│   │   ├── 9-about
│   │   └── shared    
│   ├── 2-de              
│   │   ├── 1-home        = http://website/de/
│   │   ├── 9-about
│   │   └── shared    
│   └── 3-sv              
│       ├── 1-home        = http://website/sv/
│       ├── 9-about
│       └── shared    
├── media                 
└── system                

Den första skärmdumpen visar mapparna 1-en,2-de och 3-sv. Detta ger dig webbadresserna http://website/ http://website/de/ http://website/sv/ för engelska, tyska och svenska. Här är ett annat exempel:

├── content               
│   ├── 1-en              
│   │   ├── 1-home        = http://website/en/
│   │   ├── 9-about
│   │   └── shared    
│   ├── 2-de              
│   │   ├── 1-home        = http://website/de/
│   │   ├── 9-about
│   │   └── shared    
│   ├── 3-sv              
│   │   ├── 1-home        = http://website/sv/
│   │   ├── 9-about
│   │   └── shared    
│   └── default           = http://website/       
├── media                 
└── system                

Den andra skärmdumpen visar mapparna 1-en,2-de, 3-sv och default. Detta ger dig webbadresserna http://website/en/ http://website/de/ http://website/sv/ och en hemsida http://website/ som automatiskt upptäcker besökarens språk.

För att visa ett språkval kan du skapa en sida som visar tillgängliga språk. Språkvalet kan integreras i navigeringen på din webbplats. Detta gör det möjligt för besökare att välja språk.

Gör en översättning

När du installerar en webbplats hälsas du med ett hej. Du kan göra en översättning om ett språk saknas. Börja med svenska språkfilen eller ett av tillgängliga språken. Detta visa dig vilka textrader och textfragment är tillgängliga. Det räcker om du översätter svenska språkfilen. En underhållare kan ta hand om allt annat. Läs mer om översättningar.

Har du några frågor? Få hjälp.

1969 Dec 31

Hur man ändrar systemet

Alla systemfiler finns i system mappen. Du kan anpassa din webbplats här.

Mappen system/extensions innehåller konfigurationsfilar och loggfilen. Du kan justera utseendet på din webbplats i system/layouts mappen och system/themes mappen. Du kan ändra alla layouter och teman som du vill. Vissa kunskaper i HTML, CSS och JavaScript krävs. Det är bättre om man inte ändrar filer i system/workers mappen.

Systeminställningar

Den centrala konfigurationsfilen är system/extensions/yellow-system.ini. Här är ett exempel:

Sitename: Anna Svensson Design
Author: Anna Svensson
Email: anna@svensson.com
Language: sv
Layout: default
Theme: stockholm
Parser: markdown
Status: public

Du kan använda webbläsaren eller din dator för att ändra systeminställningar. Systeminställningarna innehåller inställningarna för din webbplats och för alla installerade tillägg. Följande inställningar kan konfigureras:

Sitename = webbplatsens namn
Author = webmasterns namn
Email = webmasterns email
Language = standardspråk, t.ex. sv
Layout = standardlayout
Theme = standardtema
Parser = standard innehållsparser
Status = standard sidstatus, stödda statusvärden

Språkinställningar

Språkinställningar lagras i filen system/extensions/yellow-language.ini. Här är ett exempel:

Language: sv
CoreDescription: Kärnfunktionalitet på din webbplats.
CorePaginationPrevious: ← Tidigare
CorePaginationNext: Nästa →
CoreTimeFormatShort: H:i
CoreTimeFormatMedium: H:i:s
CoreTimeFormatLong: H:i:s T
CoreDateFormatShort: F Y
CoreDateFormatMedium: Y-m-d
CoreDateFormatLong: Y-m-d H:i
media/images/photo.jpg: Detta är en exempelbild

Du kan definiera språkinställningarna här. Ett språk består av Language och andra inställningar. Språkinställningarna innehåller inställningarna för alla installerade tillägg. Du kan också lägga till dina egna språkinställningar i konfigurationsfilen, till exempel bildtexter.

Användarinställningar

Användarinställningar lagras i filen system/extensions/yellow-user.ini. Här är ett exempel:

Email: anna@svensson.com
Name: Anna Svensson
Description: Utvecklare och formgivare
Language: sv
Access: create, edit, delete, restore, upload, configure, install, uninstall, update
Home: /
Hash: $2y$10$j26zDnt/xaWxC/eqGKb9p.d6e3pbVENDfRzauTawNCUHHl3CCOIzG
Stamp: 21196d7e857d541849e4
Pending: none
Failed: 0
Modified: 2000-01-01 13:37:00
Status: active

Du kan använda webbläsaren eller kommandoraden för att skapa nya användarkonton. Ett användarkonto består av Email och andra inställningar. Om du inte vill att sidorna ska ändras i en webbläsare begränsar du användarkonton. Öppna konfigurationsfilen, ändra Access och Home. Användare får redigera sidor på sin hemsida, men inte någon annanstans.

Tilläggsinställningar

Tilläggsinställningar lagras i filen system/extensions/yellow-extension.ini. Här är ett exempel:

Extension: Core
Version: 0.9.3
Description: Core functionality of your website.
Developer: Anna Svensson
Tag: feature
DownloadUrl: https://github.com/annaesvensson/yellow-core/archive/refs/heads/main.zip
DocumentationUrl: https://github.com/annaesvensson/yellow-core
DocumentationLanguage: en, de, sv
Published: 2024-04-24 14:38:12
Status: available
system/workers/core.php: core.php, create, update

Du kan se installerade tilläggen här. Ett tillägg består av Extension och andra inställningar. Tilläggsinställningarna innehåller information om alla installerade filer. Du kan också se vilken utvecklare, formgivare eller översättare som ansvarar för ett tillägg. Få tillägg för din webbplats.

Sidinställningar

Följande inställningar kan konfigureras högst upp på en sida:

Title = namn på sidan
TitleContent = namn på sidan som visas i innehållet
TitleNavigation = namn på sidan som visas i navigeringen
TitleHeader = namn på sidan som visas i webbläsaren
TitleSlug = namn för att spara sidan
Description = sidans beskrivning
Author = sidans författare, kommaseparerade
Email = email av sidans författare
Language = sidans språk, t.ex. sv
Layout = sidans layout
LayoutNew = sidans layout för att skapa en ny sida
Theme = sidans tema
Parser = sidans innehållsparser
Status = sidans status, stödda statusvärden
Redirect = omdirigera till en ny sida eller URL
Image = sidans bild
ImageAlt = beskrivning av sidans bild
Modified = sidans ändringsdatum, ÅÅÅÅ-MM-DD format
Published = sidans publiceringsdatum, ÅÅÅÅ-MM-DD format
Tag = taggar för kategorisering av sidan, kommaseparerade
Generate = alternativ för att generera en statisk webbplats, kommaseparerade
Comment = alternativ för att visa kommentarer, kommaseparerade

Följande sidstatusvärden stöds:

public = sidan är en vanlig sida
private = sidan är inte synlig, användaren måste ange lösenord, kräver private-tillägg
draft = sidan är inte synlig, användaren måste logga in, kräver draft-tillägg
unlisted = sidan är inte synlig, men kan nås med rätt länk
shared = sidan är inte synlig, men kan ingå i andra sidor

Loggfilen

Loggfilen finns i filen system/extensions/yellow-website.log. Här är ett exempel:

2024-04-28 14:13:07 info Install Datenstrom Yellow 0.9, PHP 8.1.27, Apache 2.4.33, Mac
2024-04-28 14:13:07 info Install extension 'Core 0.9.9'
2024-04-28 14:13:07 info Install extension 'Markdown 0.9.1'
2024-04-28 14:13:07 info Install extension 'Stockholm 0.9.2'
2024-04-28 14:13:07 info Install extension 'English 0.9.2'
2024-04-28 14:13:07 info Install extension 'German 0.9.2'
2024-04-28 14:13:07 info Install extension 'Swedish 0.9.2'
2024-04-28 14:23:11 info Install extension 'Fika 0.9.1'
2024-04-28 14:23:11 error Process file 'system/workers/fika.php' with fatal error!

Har du några frågor? Få hjälp.