Django-LiveView/docs
1
0
Fork 0
mirror of https://github.com/Django-LiveView/docs.git synced 2024-09-19 23:07:21 +02:00
Code Issues Actions Packages Projects Releases Wiki Activity
050b662d51
docs/onerc.el

162 lines
7.3 KiB
EmacsLisp
Raw Normal View History

Update images
2024-03-06 09:24:25 +01:00
;; Utils
Fix layout
2024-02-29 13:03:14 +01:00
(defun make-title (title)
Add nav mobile
2024-02-29 18:41:29 +01:00
"If title is empty, return the website name. Otherwise, return the title with the website name."
Fix layout
2024-02-29 13:03:14 +01:00
(concat (when (not (string-empty-p title)) (concat title " | ")) "Django LiveView"))
Update images
2024-03-06 09:24:25 +01:00
(defun one-ox-link (link desc info)
"Transcode a LINK object from Org to HTML.
DESC is the description part of the link, or the empty string.
INFO is a plist holding contextual information."
(let* ((type (org-element-property :type link))
(path (org-element-property :path link))
(raw-link (org-element-property :raw-link link))
(custom-type-link
(let ((export-func (org-link-get-parameter type :export)))
(and (functionp export-func)
(funcall export-func path desc 'one-ox info))))
(href (cond
((string= type "custom-id") path)
((string= type "fuzzy")
(let ((beg (org-element-property :begin link)))
(signal 'one-link-broken
`(,raw-link
"fuzzy links not supported"
,(format "goto-char: %s" beg)))))
((string= type "file")
(or
;; ./assets/images/image-1.png --> /images/image-1.png
;; ./public/blog/page-1.md --> /blog/page-1.md
(and (string-match "\\`\\./\\(assets\\|public\\)" path)
(replace-match "" nil nil path))
(let ((beg (org-element-property :begin link)))
(signal 'one-link-broken
`(,raw-link ,(format "goto-char: %s" beg))))))
(t raw-link)))
(class (if-let ((parent (org-export-get-parent-element link))
(class (plist-get (org-export-read-attribute :attr_html parent)
:class)))
(concat " class=\"" class "\" ")
" ")))
(or custom-type-link
(and
(string-match one-ox-link-image-extensions path)
(format "<p><img%ssrc=\"%s\" alt=\"%s\" /></p>"
class href (or (org-string-nw-p desc) href)) )
(format "<a%shref=\"%s\">%s</a>"
class href (or (org-string-nw-p desc) href)))))
;; Layouts
Fix layout
2024-02-29 13:03:14 +01:00
(defun render-layout-html (title description tree-content)
Add nav mobile
2024-02-29 18:41:29 +01:00
"Render the HTML layout with the given title, description and content."
(let ((full-title (make-title title)))
(jack-html
"<!DOCTYPE html>"
`(:html (@ :lang "en")
(:head
;; Generals
(:meta (@ :charset "utf-8"))
(:link (@ :rel "icon" :type "image/png" :href "/img/favicon.png"))
(:meta (@ :name "viewport" :content "width=device-width,initial-scale=1.0, shrink-to-fit=no"))
(:meta (@ :name "author" :content "Andros Fenollosa"))
(:meta (@ :name "generator" :content "One.el"))
;; SEO
(:title ,full-title)
(:meta (@ :name "description" :content ,description))
(:meta (@ :name "og:image" :content "https://django-liveview.andros.dev/img/og-image.webp"))
;; Fonts
(:link (@ :rel "preconnect" :href "https://fonts.googleapis.com"))
(:link (@ :rel "preconnect" :href "https://fonts.gstatic.com" :crossorigin t))
(:link (@ :rel "stylesheet" :href "https://fonts.googleapis.com/css2?family=Fira+Code&family=Open+Sans:wght@400;700&display=swap"))
;; CSS
(:link (@ :rel "stylesheet" :type "text/css" :href "https://cdnjs.cloudflare.com/ajax/libs/normalize/8.0.1/normalize.min.css"))
(:link (@ :rel "stylesheet" :type "text/css" :href "/css/main.css")))
(:body
(:header.header
(:div.container
(:nav.nav-main
(:ul.nav__list.nav-main__list
(:li.nav-main__item
(:a.nav-main__link.nav-main__link--logo (@ :href "/") (:img.nav-main__logo (@ :alt "Django LiveView" :src "/img/logo.webp"))))
(:li.nav-main__item
(:a.button.nav-main__link (@ :href "/docs/quickstart/") "Docs"))
Comment link to tutorials
2024-03-05 09:47:56 +01:00
;; (:li.nav-main__item
;; (:a.button.nav-main__link (@ :href "/tutorials/") "Tutorials"))
Add nav mobile
2024-02-29 18:41:29 +01:00
(:li.nav-main__item
Add aside
2024-03-01 09:00:24 +01:00
(:a.button.nav-main__link (@ :href "/source-code/") "Source code"))
Add nav mobile
2024-02-29 18:41:29 +01:00
(:li.nav-main__item
(:a.button.nav-main__link (@ :href "https://django-liveview-demo.andros.dev/" :target "_blank") "Demo"))))))
,tree-content
(:footer.footer
Update footer
2024-03-06 15:28:51 +01:00
(:p "Created with ❤️ by " (:a.link (@ :href "https://andros.dev/" :target "_blank") "Andros Fenollosa") " with " (:a.link (@ :href "https://one.tonyaldon.com/" :target "_blank") "one.el"))
Add nav mobile
2024-02-29 18:41:29 +01:00
(:p "🐍 " ,(format-time-string "%Y"))))))))
Fix layout
2024-02-29 13:03:14 +01:00
Add aside
2024-03-01 09:00:24 +01:00
(defun one-custom-default-page (page-tree pages _global)
"Default render function by home page."
(let* ((title (org-element-property :raw-value page-tree))
(description (org-element-property :DESCRIPTION page-tree))
(path (org-element-property :CUSTOM_ID page-tree))
(content (org-export-data-with-backend
(org-element-contents page-tree)
'one-ox nil))
(website-name (one-default-website-name pages))
(nav (one-default-nav path pages)))
(render-layout-html
title
description
(jack-html `(:main.main
(:section
(:div.container ,content)))))))
Add first page
2024-02-28 18:49:12 +01:00
(defun one-custom-default-home (page-tree pages _global)
"Default render function by home page."
(let* ((title (org-element-property :TITLE page-tree))
(path (org-element-property :CUSTOM_ID page-tree))
(description (org-element-property :DESCRIPTION page-tree))
(content (org-export-data-with-backend
(org-element-contents page-tree)
'one-ox nil))
(website-name (one-default-website-name pages))
(nav (one-default-nav path pages)))
Fix layout
2024-02-29 13:03:14 +01:00
(render-layout-html
title
description
(jack-html `(:main.main
Add aside
2024-03-01 09:00:24 +01:00
(:section.hero
(:div.container
(:hgroup.hero__hgroup
(:h1.hero__title "Django LiveView")
(:h2.hero__subtitle "Framework for creating Realtime SPAs using HTML over the Wire technology")
(:img.image.hero__logo (@ :alt "pet" :src "img/pet.webp")))))
Update
2024-03-04 15:36:50 +01:00
(:section.home
Add aside
2024-03-01 09:00:24 +01:00
(:div.container ,content)))))))
Add first page
2024-02-28 18:49:12 +01:00
(defun one-custom-default-doc (page-tree pages _global)
"Default render function by home page."
Add files
2024-02-28 13:12:16 +01:00
(let* ((title (org-element-property :raw-value page-tree))
Fix layout
2024-02-29 13:03:14 +01:00
(description (org-element-property :DESCRIPTION page-tree))
Add first page
2024-02-28 18:49:12 +01:00
(path (org-element-property :CUSTOM_ID page-tree))
Add files
2024-02-28 13:12:16 +01:00
(content (org-export-data-with-backend
(org-element-contents page-tree)
'one-ox nil))
(website-name (one-default-website-name pages))
(nav (one-default-nav path pages)))
Add nav
2024-02-29 17:08:43 +01:00
(render-layout-html
Fix layout
2024-02-29 13:03:14 +01:00
title
description
Add aside
2024-03-01 09:00:24 +01:00
(jack-html `(:div.container.docs
(:aside.aside-docs
(:nav.nav-docs
(:ul.nav__list.nav__list--docs.nav-docs__list
(:li.nav-docs__item
(:a.nav-docs__link (@ :href "/docs/quickstart/") "Quickstart"))
Update
2024-03-05 09:42:05 +01:00
(:li.nav-docs__item
(:a.nav-docs__link (@ :href "/docs/views/") "Views"))
Add deploy
2024-03-03 09:43:13 +01:00
(:li.nav-docs__item
(:a.nav-docs__link (@ :href "/docs/deploy/") "Deploy"))
Add aside
2024-03-01 09:00:24 +01:00
(:li.nav-docs__item
(:a.nav-docs__link (@ :href "/docs/faq/") "FAQ"))
Update
2024-03-01 09:20:05 +01:00
)))
Update
2024-03-01 09:03:44 +01:00
(:main.main.main--docs
Add aside
2024-03-01 09:00:24 +01:00
,content))))))
Reference in New Issue Copy Permalink