This commit is contained in:
Cagatay Civici
2024-07-30 09:11:50 +03:00
parent fa23cdfda2
commit d97b058bf8
6 changed files with 43 additions and 39 deletions

View File

@@ -1,15 +1,17 @@
pre.app-code { pre.app-code {
background-color: var(--surface-ground); background-color: var(--code-background);
margin: 0 0 1rem 0; margin: 0 0 1rem 0;
padding: 0; padding: 0;
border-radius: var(--border-radius); border-radius: var(--content-border-radius);
overflow: auto; overflow: auto;
code { code {
color: var(--surface-900); color: var(--code-color);
padding: 1rem; padding: 1rem;
margin: 0;
line-height: 1.5; line-height: 1.5;
display: block; display: block;
font-weight: semibold;
font-family: monaco, Consolas, monospace; font-family: monaco, Consolas, monospace;
} }
} }

View File

@@ -1,3 +1,5 @@
:root[class*='app-dark'] { :root[class*='app-dark'] {
--surface-ground: var(--p-surface-950); --surface-ground: var(--p-surface-950);
--code-background: var(--p-surface-800);
--code-color: var(--p-surface-100);
} }

View File

@@ -1,3 +1,5 @@
:root { :root {
--surface-ground: var(--p-surface-100); --surface-ground: var(--p-surface-100);
--code-background: var(--p-surface-900);
--code-color: var(--p-surface-200);
} }

View File

@@ -20,7 +20,7 @@ const model = ref([
{ label: 'Panel', icon: 'pi pi-fw pi-tablet', to: '/uikit/panel' }, { label: 'Panel', icon: 'pi pi-fw pi-tablet', to: '/uikit/panel' },
{ label: 'Overlay', icon: 'pi pi-fw pi-clone', to: '/uikit/overlay' }, { label: 'Overlay', icon: 'pi pi-fw pi-clone', to: '/uikit/overlay' },
{ label: 'Media', icon: 'pi pi-fw pi-image', to: '/uikit/media' }, { label: 'Media', icon: 'pi pi-fw pi-image', to: '/uikit/media' },
{ label: 'Menu', icon: 'pi pi-fw pi-bars', to: '/uikit/menu', preventExact: true }, { label: 'Menu', icon: 'pi pi-fw pi-bars', to: '/uikit/menu' },
{ label: 'Message', icon: 'pi pi-fw pi-comment', to: '/uikit/message' }, { label: 'Message', icon: 'pi pi-fw pi-comment', to: '/uikit/message' },
{ label: 'File', icon: 'pi pi-fw pi-file', to: '/uikit/file' }, { label: 'File', icon: 'pi pi-fw pi-file', to: '/uikit/file' },
{ label: 'Chart', icon: 'pi pi-fw pi-chart-bar', to: '/uikit/charts' }, { label: 'Chart', icon: 'pi pi-fw pi-chart-bar', to: '/uikit/charts' },

View File

@@ -106,11 +106,6 @@ const router = createRouter({
} }
] ]
}, },
{
path: '/landing',
name: 'landing',
component: () => import('@/views/pages/Landing.vue')
},
{ {
path: '/pages/notfound', path: '/pages/notfound',
name: 'notfound', name: 'notfound',

View File

@@ -1,47 +1,50 @@
<template> <template>
<div class="card"> <div class="card">
<h3>Documentation</h3> <div class="font-semibold text-2xl mb-4">Documentation</div>
<p class="bg-primary text-primary-contrast rounded-border p-4"> <div class="font-semibold text-xl mb-4">Get Started</div>
This page covers the Vite version, for Nuxt 3 visit the <a href="https://github.com/primefaces/sakai-nuxt" class="font-bold bg-primary text-primary-contrast hover:underline">sakai-nuxt</a> repository instead. <p class="text-lg mb-4">
</p>
<h5>Getting Started</h5>
<p>
Sakai is an application template for Vue based on the <a href="https://github.com/vuejs/create-vue" class="font-medium text-primary hover:underline">create-vue</a>, the recommended way to start a <strong>Vite-powered</strong> Vue Sakai is an application template for Vue based on the <a href="https://github.com/vuejs/create-vue" class="font-medium text-primary hover:underline">create-vue</a>, the recommended way to start a <strong>Vite-powered</strong> Vue
projects. To get started, clone the <a href="https://github.com/primefaces/sakai-vue" class="font-medium text-primary hover:underline">repository</a> from GitHub and install the dependencies with npm or yarn. projects. To get started, clone the <a href="https://github.com/primefaces/sakai-vue" class="font-medium text-primary hover:underline">repository</a> from GitHub and install the dependencies with npm or yarn.
</p> </p>
<pre class="app-code"><code> npm install </code></pre> <pre class="app-code">
<code>git clone https://github.com/primefaces/sakai-vue
npm install
npm run dev</code></pre>
<p>or</p> <p class="text-lg mb-4">Navigate to <i class="bg-highlight px-2 py-1 rounded-border not-italic text-base">http://localhost:5173/</i> to view the application in your local environment.</p>
<pre class="app-code"><code> yarn </code></pre> <pre class="app-code"><code>npm run dev</code></pre>
<p>Next step is running the application using the serve script and navigate to <i>http://localhost:5173/</i> to view the application. That is it, you may now start with the development of your application using the Sakai template.</p> <div class="font-semibold text-xl mb-4">Structure</div>
<p class="text-lg mb-4">Templates consists of a couple folders, demos and layout have been separated so that you can easily remove what is not necessary for your application.</p>
<pre class="app-code"><code> npm run dev </code></pre> <ul class="leading-normal list-disc pl-8 text-lg mb-4">
<li><span class="text-primary font-medium">src/layout</span>: Main layout files, needs to be present.</li>
<h5>Structure</h5> <li><span class="text-primary font-medium">src/views</span>: Demo pages like Dashboard.</li>
<p>Sakai consists of a couple folders, demos and layout have been separated so that you can easily remove what is not necessary for your application.</p>
<ul class="leading-normal">
<li><span class="text-primary font-medium">src/layout</span>: Main layout files, needs to be present</li>
<li><span class="text-primary font-medium">src/views</span>: Demo pages</li>
<li><span class="text-primary font-medium">public/demo</span>: Assets used in demos</li> <li><span class="text-primary font-medium">public/demo</span>: Assets used in demos</li>
<li><span class="text-primary font-medium">public/layout</span>: Assets used in layout</li>
<li><span class="text-primary font-medium">src/assets/demo</span>: Styles used in demos</li> <li><span class="text-primary font-medium">src/assets/demo</span>: Styles used in demos</li>
<li><span class="text-primary font-medium">src/assets/layout</span>: SCSS files of the main layout</li> <li><span class="text-primary font-medium">src/assets/layout</span>: SCSS files of the main layout</li>
</ul> </ul>
<h5>Menu</h5> <div class="font-semibold text-xl mb-4">Menu</div>
<p>Main menu is defined at <span class="text-primary font-medium">src/layout/AppMenu.vue</span> file.</p> <p class="text-lg mb-4">
Main menu is defined at <span class="bg-highlight px-2 py-1 rounded-border not-italic text-base">src/layout/AppMenu.vue</span> file. Update the <i class="bg-highlight px-2 py-1 rounded-border not-italic text-base">model</i> property to
define your own menu items.
</p>
<h5>Integration with Existing Vite Applications</h5> <div class="font-semibold text-xl mb-4">Layout Composable</div>
<p>Only the folders that are related to the layout needs to move in to your project. We've created a short tutorial with details.</p> <p class="text-lg mb-4">
The <span class="bg-highlight px-2 py-1 rounded-border not-italic text-base">src/layout/composables/layout.js</span> is a composable that manages the layout state changes including dark mode, PrimeVue theme, menu modes and states. If you
change the initial values like the preset or colors, make sure to apply them at PrimeVue config at main.js as well.
</p>
<div class="video-container"> <div class="font-semibold text-xl mb-4">Tailwind CSS</div>
<iframe className="video" width="560" height="315" src="https://www.youtube.com/embed/AHeSjJFR3ZE" frameborder="0" allowfullscreen></iframe> <p class="text-lg mb-4">The demo pages are developed with Tailwind CSS however the core application shell mainly uses custom CSS.</p>
</div>
<h5>PrimeVue Theme</h5> <div class="font-semibold text-xl mb-4">Variables</div>
<p>Sakai theming is based on the PrimeVue theme being used. Default theme is <b>lara-light-indigo</b>.</p> <p class="text-lg mb-4">
CSS variables used in the template derive their values from the PrimeVue styled mode presets, use the files under <span class="bg-highlight px-2 py-1 rounded-border not-italic text-base">assets/layout/_variables.scss</span> to customize
according to your requirements.
</p>
</div> </div>
</template> </template>