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.

1969 Dec 31

Hur man ändrar medierna

Alla mediefiler finns i media mappen. Du kan lagra dina bilder och andra filer här.

Mappen media/downloads innehåller filer för nedladdning. Mappen media/images är platsen för att lagra dina bilder. Mappen media/thumbnails innehåller miniatyrbilder. Du kan också lägga till fler mappar och organisera filer som du vill. I grund och botten kan alla mediefiler laddas ner från webbplatsen.

Filer för nedladdning

Du kan tillhandahålla filer för nedladdning. Alla filformat stöds, men uppladdning kan vara begränsad till filformat MP3, OGG, PDF och ZIP. För att lägga till en fil, kopiera filen till media/downloads mappen och skapa en länk. Du kan också ladda upp filer i en webbläsare, sedan läggs länken till på önskad plats.

Skapa en länk, olika filformat:

[Ladda ner PDF-fil](/media/downloads/yellow-svenska.pdf)
[Ladda ner ZIP-fil](/media/downloads/yellow-main.zip)
[Ladda ner audio-fil](/media/downloads/audio-file.mp3)

Bilder

Du kan använda image-tillägget för att bädda in bilder. Bildformaten GIF, JPEG, PNG och SVG stöds. För att lägga till en bild, kopiera bilden till media/images mappen och skapa en [image] förkortning. Du kan också ladda upp bilder i en webbläsare, sedan läggs bilden till på önskad plats.

Lägga till en bild, olika beskrivningar:

[image photo.jpg Exempel]
[image photo.jpg "Detta är en exempelbild"]
[image photo.jpg "Detta är en särskilt lång beskrivning"]

Lägga till en bild, olika stilar:

[image photo.jpg Exempel left]
[image photo.jpg Exempel center]
[image photo.jpg Exempel right]

Lägga till en bild, olika storlekar:

[image photo.jpg Exempel right 50%]
[image photo.jpg Exempel right 64 64]
[image photo.jpg Exempel right 320 200]

Lägga till en bild, olika storlekar med standardstilen:

[image photo.jpg Exempel - 50%]
[image photo.jpg Exempel - 64 64]
[image photo.jpg Exempel - 320 200]

Bildgallerier

Du kan använda gallery-tillägget eller slider-tillägget för att bädda in bildgallerier. Bildformaten GIF, JPEG, PNG och SVG stöds. För att lägga till ett bildgalleri, kopiera bilder till media/images mappen och skapa en [gallery] förkortning. Du kan också ladda upp bilder i en webbläsare.

Lägga till ett bildgalleri med popup, olika sorteringar:

[gallery photo.*jpg name]
[gallery photo.*jpg modified]
[gallery photo.*jpg size]

Lägga till ett bildgalleri med popup, olika storlekar:

[gallery photo.*jpg name zoom 25%]
[gallery photo.*jpg name zoom 50%]
[gallery photo.*jpg name zoom 100%]

Lägga till ett bildgalleri med reglaget, olika sorteringar:

[slider photo.*jpg name]
[slider photo.*jpg modified]
[slider photo.*jpg size]

Lägga till ett bildgalleri med reglaget, olika storlekar:

[slider photo.*jpg name loop 25%]
[slider photo.*jpg name loop 50%]
[slider photo.*jpg name loop 100%]

Videor

Du kan använda Youtube-tillägget för att bädda in videor:

Bädda in en video, olika videor:

[youtube fhs55HEl-Gc]
[youtube wNiyp89pTi0]
[youtube OV5J6BfToSw]

Bädda in en video, olika storlekar:

[youtube fhs55HEl-Gc right 50%]
[youtube fhs55HEl-Gc right 200 112]
[youtube fhs55HEl-Gc right 400 224]

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

1969 Dec 31

Hur man ändrar innehållet

Alla innehållsfiler finns i content mappen. Du kan redigera din webbplats här.

Din content mapp finns tillgängliga på din webbplats. Varje mapp har en fil som heter page.md. Du kan lägga till fler filer och mappar. Du kan också använda specialtecken i fil- och mappnamn, till exempel ÄÖÅ. Med andra ord det du ser i filhanteraren är webbplatsen du får.

Filer och mappar

Din webbplats skapas automatiskt från din content mapp:

  1. Mappar kan ha ett numeriskt prefix för sortering, t.ex. 1-home eller 9-about
  2. Filer kan ha ett numeriskt prefix för sortering, t.ex. 2020-04-07-blog-example.md
  3. Filer och mappar utan prefix har ingen speciell betydelse, t.ex. wiki-example.md

Prefix och suffix tas bort från adressen, så att det ser bättre ut. Till exempel mappen content/1-home är tillgänglig på din webbplats som http://website/. Mappen content/9-about är tillgänglig på din webbplats som http://website/about/. Filen content/2-wiki/wiki-example.md är tillgänglig på din webbplats som http://website/wiki/wiki-example.

Medan flesta mappar är tillgängliga på din webbplats, finns det två undantag. Mappen content/1-home får inte innehålla undermappar. Mappen content/shared får bara inkluderas på andra mappar, den är inte direkt tillgänglig på din webbplats.

Text

Du kan redigera din webbplats i en webbläsare eller textredigerare. Högst upp på en sida kan du ändra Title och andra sidinställningar. Nedan kan du ändra text och bilder. Textformatering med Markdown stöds. HTML stöds också. Här är några exempel:

---
Title: Exempelsida
---
Detta är en exempelsida.

Lorem ipsum dolor sit amet, consectetur adipisicing elit, sed do eiusmod 
tempor incididunt ut labore et dolore magna pizza. Ut enim ad minim veniam, 
quis nostrud exercitation ullamco laboris nisi ut aliquip ex ea commodo. 

Formatera text:

Normal **fet** *kursiv* ~~struken~~ `code`

Skapa en lista:

* objekt ett
* objekt två
* objekt tre

Skapa en sorterad lista:

1. objekt ett
2. objekt två
3. objekt tre

Skapa en uppgiftslista:

- [x] objekt ett
- [ ] objekt två
- [ ] objekt tre

Skapa en rubrik:

# Rubrik 1
## Rubrik 2
### Rubrik 3

Skapa citat:

> Citat
>> Citat i citat
>>> Citat i citat i citat

Skapa länkar:

[Länk till sidan](/help/how-to-make-a-small-website)
[Länk till fil](/media/downloads/yellow-svenska.pdf)
[Länk till webbplats](https://datenstrom.se/sv/)

Lägga till bilder:

[image photo.jpg Exempel]
[image photo.jpg "Detta är en exempelbild"]
[image photo.jpg "Detta är en särskilt lång beskrivning"]

Skapa tabeller:

| Kaffe      | Mjölk | Styrka  |
|------------|-------|---------|
| Espresso   | nej   | stark   |
| Macchiato  | ja    | medium  |
| Cappuccino | ja    | svag    |

Skapa fotnoter:

Text med en fotnot[^1] och några fler fotnoter.[^2] [^3]

[^1]: Här är den första fotnoten
[^2]: Här är den andra fotnoten
[^3]: Här är den tredje fotnoten

Visa källkod:

```
Källkoden visas oförändrad.
function onLoad($yellow) {
    $this->yellow = $yellow;
}
```

Skapa paragraf:

Här är första paragrafen. Text kan sträcka sig över flera rader
och kan separeras med en tom rad från nästa paragrafen.

Här är andra paragrafen. 

Skapa radbrytningar:

Här är första raden⋅⋅
Här är andra raden⋅⋅
Här är tredje raden⋅⋅

Mellanslag i slutet av raden representeras av prickar (⋅)

Skapa indikationer:

! Här är en indikation med varning 

!! Här är en indikation med fel

!!! Här är en indikation med tip

Använd CSS:

! {.class}
! Här är en indikation med anpassad klass.
! Text kan sträcka sig över flera rader
! och innehåller Markdown-textformatering.

Använd HTML:

<strong>Text med HTML</strong> kan valfritt användas.
<img src="/media/images/photo.jpg" alt="This is an example image">
<a href="https://datenstrom.se" target="_blank">Öppna länken i en ny flik</a>.

Använd förkortningar med ytterligare funktioner:

[image photo.jpg]    = lägga till en bild eller miniatyrbild
[gallery photo.*jpg] = lägga till ett bildgalleri med popup
[slider photo.*jpg]  = lägga till ett bildgalleri med reglaget

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