The goal of this library is to support in handling of basic stuff like Table Of Contents, embedded source code or heading indentation levels. Giving documentation a personal touch like styling via CSS or using JavaScript shall be straight forward.
The library comes to its full potential, when Lisp documentation strings are using HTML as markup language. However, it doesn't provide any functionality to extract documentation from systems or packages.
The general idea is to declare an HTML skeleton using the DSL of cl-html-readme and to provide the actual documentation and any arbitrary markup as plain HTML strings embedded into this skeleton.
The key features of cl-html-readme are:
The source code is available here.
The first release of cl-html-readme.
This version is the current quicklisp release.
(ql:quickload "cl-html-readme")
The following HTML snippets have been formatted with sgml-pretty-print
. The library
itself does not support pretty-printing
((heading (:name "Example"))
(heading (:name "Table of contents")
(toc))
(heading (:name "Chapter 1" :toc t)) "Lorem ipsum"
(heading (:name "Chapter 2" :toc t)) "Lorem ipsum")))

Example

Table of contents

Chapter 1

Chapter 2

Chapter 1

Lorem ipsum

Chapter 2

Lorem ipsum
((semantic (:name "header")
(heading (:name "Example")))
(semantic (:name "nav")
(heading (:name "Table of contents")
(toc)))
(semantic (:name "section")
(heading (:name "Chapter 1" :toc t))
"Lorem ipsum"
(heading (:name "Chapter 2" :toc t))
"Lorem ipsum")
(semantic (:name "footer") "Lorem ipsum"))

Example

Table of contents

Chapter 1

Chapter 2

Chapter 1

Lorem ipsum

Chapter 2

Lorem ipsum

Lorem ipsum

((semantic (:name "header" :class "semantic-class" :style "semantic-style" )
(heading (:name "Example" :class "heading-class" :style "heading-style")))
(semantic (:name "nav")
(heading (:name "Table of contents")
(toc (:root-class "toc-root-class"
:root-style "toc-root-style"
:container-class "toc-container-class"
:container-style "toc-container-style"
:item-class "toc-item-class"
:item-style "toc-item-style"))))
(semantic (:name "section")
(heading (:name "Chapter 1" :toc t)
"Lorem ipsum"
(heading (:name "Chapter 1.1" :toc t)
"Lorem ipsum"))
(heading (:name "Chapter 2" :toc t))
"Lorem ipsum")
(semantic (:name "footer") "Lorem ipsum"))

Example

Table of contents

Chapter 1

Chapter 1.1

Chapter 2

Chapter 1

Lorem ipsum

Chapter 1.1

Lorem ipsum

Chapter 2

Lorem ipsum

Lorem ipsum

Home directory of the project for which documentation is to be generated.
*tab-width*Width of a tab. Used, when tabs are to be replaced with space characters.
doc-to-html (output-stream documentation)Serializes a documentation object to HTML. The function has the following parameters:
Creates an absolute path. The function has the following parameters:
Reads a text file and returns it as a string. The function has the following parameters:
(in-package :cl-html-readme-make-doc)
;;
;; Helper functions
;;
(defun make-index (system)
(docparser:parse system))
(defun get-index-node (index package-name symbol-name)
(aref (docparser:query
index
:package-name (string-upcase package-name)
:symbol-name (string-upcase symbol-name))
0))
(defun make-function-string (index package-name symbol-name)
"Returns HTML representation of a function"
(let* ((node (get-index-node index package-name symbol-name))
(lambda-list (docparser:operator-lambda-list node)))
(concatenate
'string
"" (string-downcase symbol-name) " "
(string-downcase (format nil "~a" (if lambda-list lambda-list "()")))
"
" (docparser:node-docstring node) "
")))
(defun make-variable-string (index package-name symbol-name)
"Returns HTML representation of a variable"
(let ((node (get-index-node index package-name symbol-name)))
(concatenate
'string
"" (string-downcase symbol-name) ""
"
" (docparser:node-docstring node) "
")))
(defun make-code-string (path)
"Returns HTML representation of a source code file"
(concatenate
'string
"

"
(cl-html-readme:read-file path :replace-tabs t :escape t)
"

"))
(defun now ()
"Returns a string representing the current date and time."
(multiple-value-bind (sec min hr day mon yr dow dst-p tz)
(get-decoded-time)
(declare (ignore dow dst-p tz))
;; 2018-09-19 21:28:16
(let ((str (format nil "~4,'0d-~2,'0d-~2,'0d ~2,'0d:~2,'0d:~2,'0d" yr mon day hr min sec)))
str)))
;;
;; Readme
;;
(defun get-readme (index)
`(""
"<link href=\"cl-html-readme.css\" rel=\"stylesheet\" type=\"text/css\"/>"
""
(semantic (:name "header")
(heading (:name "cl-html-readme"))
,(cl-html-readme:read-file "make-readme/introduction.html")
"
The source code is available here.
")
(semantic (:name "nav")
(heading (:name "Table of contents")
(toc)))
(semantic (:name "section")
(heading (:name "Change-Log" :toc t)
(heading (:name "Version 1.0.0")
"
The first release of cl-html-readme.
")
(heading (:name "Version 1.0.1")
"
This version is the current quicklisp release.
"
(heading (:name "Changes")
"
"
"
HTML serialization inserts linebreaks for better readability and diff friendliness.
"
"
Removed a couple of too fragile tests.
"
"
")))
(heading (:name "Installation" :toc t)
,(cl-html-readme:read-file "make-readme/installation.html"))
(heading (:name "DSL" :toc t)
,(cl-html-readme:read-file "make-readme/dsl-introduction.html")
(heading (:name "Heading elements and Table of Contents" :toc t)
(heading (:name "DSL")
,(make-code-string "make-readme/dsl-example-plain.dsl"))
(heading (:name "Generated HTML")
,(make-code-string "make-readme/dsl-example-plain.html")))
(heading (:name "Semantic elements" :toc t)
(heading (:name "DSL")
,(make-code-string "make-readme/dsl-example-semantic.dsl"))
(heading (:name "Generated HTML")
,(make-code-string "make-readme/dsl-example-semantic.html")))
(heading (:name "Classes and Styles" :toc t)
(heading (:name "DSL")
,(make-code-string "make-readme/dsl-example-styling.dsl"))
(heading (:name "Generated HTML")
,(make-code-string "make-readme/dsl-example-styling.html"))))
(heading (:name "API" :toc t)
,(make-variable-string index "cl-html-readme" "*home-directory*")
,(make-variable-string index "cl-html-readme" "*tab-width*")
,(make-function-string index "cl-html-readme" "doc-to-html")
,(make-function-string index "cl-html-readme" "make-path")
,(make-function-string index "cl-html-readme" "read-file"))
(heading (:name "Full example" :toc t)
,(cl-html-readme:read-file "make-readme/example-introduction.html")
(heading (:name "make-doc.lisp")
,(make-code-string "make-readme/make-doc.lisp")))
(heading (:name "Run tests" :toc t)
"
(asdf:test-system :cl-html-readme)
")
(heading (:name "Generate documentation" :toc t)
,(make-code-string "make-readme/generate-doc.lisp")))
(semantic (:name "footer")
"

Generated " ,(now) "
")
""))
;;
;; Generate readme
;;
(defun make-doc ()
(let ((index (make-index :cl-html-readme)))
(let ((cl-html-readme:*home-directory*
(asdf:system-source-directory :cl-html-readme))
(cl-html-readme:*tab-width* 4))
(with-open-file (fh (cl-html-readme:make-path "docs/index.html")
:direction :output
:if-exists :supersede
:if-does-not-exist :create
:external-format :utf-8)
(cl-html-readme:doc-to-html fh (get-readme index)))))
"DONE")
;;(make-doc)
(asdf:test-system :cl-html-readme)
(asdf:load-system :cl-html-readme/doc)
(cl-html-readme-make-doc::make-doc)


This page has moved to http://colinleath.gweb.io/
I'm attempting to get the ColinLeath.com to point there. . .


| HelloWorld Demo | A simple demo to start with. |
| Arrival/Departure Demo | Example on picking arrival/departure dates. |
| Classic Demo | Another classic demo exhibits how to create dynamical date constraints. |
| Cross Frame Demo | Date pickers working across different frames and iframes. |
| Netscape4 Demo | How to work around with form elements in Netscape 4.x |
| Range Picker | Quick-pick a date range. |
| Week Picker | A versatile date picker that can even pick a whole week. |
| Datetime Picker | Date & time picker theme . |
Please take a look at the "demos" directory for other wonderful demos!!!


Why?
There are over 650 million people in Africa who have no access to electricity; this is in sharp contrast to the lack of investments in energy infrastructure and the continent’s untapped
renewable energy potential
What?
The PV-DESI index aims to identify the most favourable countries to invest in PV decentralised options (including financial, environmental, and political factors)
To whom?
Designed for private sector, international donors, governments, and philanthropic stakeholders who wants to invest in solar PV decentralised options.
How?
The index is composed by 52 indicators classified in 4 pillars that effects stakeholder decision-making on PV mini-grid investments: economic, social, financial and environmental considerations
The financial and political pilars are defined positively when the financial and political situations in a country are stable
The environmental pilar is positive when the environmental conditions are favourable to PV mini-grids implementation
The social pilar is considered positive when the impacts of investing in PV mini-grids results in higher impacts. Therefore, indirectly when social conditions in the country are lower, the “attractiveness” for the different stakeholders
is higher because the impact of bringing electricity can cause higher social impacts.


GOT LOST
Something lost it's way and came to you just to show the world how honest you are!
Or if you've lost something just chill! People here are damnnn cool!
WHAT WE DO
We try to reduce students stress somewhat by heping them if they
lost something precious on the college/hostle grounds.
There are two sections where you can go to one is the
LOST section and the
other is the
FOUND section. You can
inform other people about what precious belonging you’ve lost and
ask your fellow students for help and if you’ve found something
then you can be of help to somebody else. Both the sections have
their respective instructions.
And the faculty involvement in this procedure is about nill, so it
also helps in creating a strong bond between the kids and also to
maintain transparency.
OUR SERVICES
Lost
- Only the property lost on College or Hostel can be reported.
- Maximum time for filing any lost report should be 2 days.
- Try to be as much detailed as you can be.
- Head towards the form below if you have lost your property.
Found
- Below is the form, if you've found a lost property on college/hostel.
- Please try to report as soon as possible so that you can help someone in need.
- The involvement of faculty will be kept as minimum as possible by our side, so that this might also help in student's ability to build connections.
- If nobody comes forward for the property you found, only then the faculty will get involved.
RECENT RETURNS
CELLPHONE
Return By : Ishan Mishra
WRIST WATCH
Return By : Rawat Senpai
WATER BOTTLE
Return By : Srishti Shukla
AIRPPODS
Return By : MR. PALINDROME
FOOTBALL
Return By : MESSI
HEADPHONE
Return By : CHRISTENSON
OUR MISSION
Our mission is to make the students community more trustworthy and
faithful and this place a safe space for all of your precious
belongings.
We all know the students have to bring many sorts of precious
belongings to college for many reasons and there are many chances
of loosing it which might give the students some permanent scars
because who knows what insane amount of value a little thing might
hold in a person’s life but don’t worry that’s where our page and
your fellow collegemates come forward to help you ! We don’t want
you to be stressed if you’ve lost something on the college and
hostel grounds we just want you to fill the form under the
LOST section so that we
can get you out of this stress ASAP.
Even this page is created and managed by some of the students, so
your fellow collegemates have already started helping you in a
way.
TESTIMONIALS
Not gonna lie friends, it really worked for me, I lost my watch and was abe to retrieve it within a week. And the relief i got after that was just immense. Can’t thank you guys enough.
Here to share this wonderful experience when i lost my book and luckily a senior from the course same as mine returned it to me and they also help me with my acedemics very often now. Thanks a lot fot this.
At first i didn’t put so much faith in this, but later when I got back my Headphone I can’t express how good I felt. And I never imagined that i’ll get it back but i was wrong and i got it back. And i never knew that my collegemates were so good and helpful. Thanks guys it means a lot.


Assessment #10: Advanced Methods
Languages
- Agile Project Management
- GitHub Gist
- Heroku
Primary Goals
Demonstrate understanding of Week 10 concepts.
Overview
In this project, you will create a text file and describe this week’s concepts in your own words. You may use copied code examples, but not copied explanations. You have 2 hours.
Basic Requirements
Deploying to Heroku
- [ ] Provide a link to the React Eventonica site you’ve deployed on Heroku.
Recursion
- [ ] Paste an example of recursion here, and explain in your own words what is happening in the code.
Memoization
- [ ] Paste an example of memoization here, and explain what is happening in the code.
Maps & Sets
- [ ] Paste an example of a javascript map here, and explain what is happening in the code.
- [ ] What is the difference between an object and a hash map?
- [ ] Paste an example of javascript set here, and explain what is happening in the code.
Agile Development
- [ ] Why is Agile so popular in the software development world?
- [ ] Explain the difference between plan-driven and Agile development?
- [ ] What are some of the most important Agile values and principles?
- [ ] Name and explain the purpose of at least 2 Agile methods or tools.
Refactoring
- [ ] What is the point of refactoring?
- [ ] When should you refactor? When shouldn’t you?
- [ ] What are some potential impacts of refactoring?
Functional Programming
Describe the uses of these functional programming methods:
- [ ] map
- [ ] filter
- [ ] reduce
- [ ] mutation
Optimization
- [ ] explain caching
- [ ] explain minification
Submitting your assessment
- [ ] Put your completed assessment text in a GitHub Gist, and send the link to your Program Manager.


So here is a spirited away trailer.
Here are some facts about spirited away:
1. One of the studio ghibli movies (top 3)
2. It was the first foreign animated movie to win an oscar
3. I love it with my whole heart


Chapter 2 The Woman Named Wisdom Calls Out
2.1 Proverbs 8:1-5
Doesn’t wisdom cry out?
Doesn’t understanding raise her voice?
On the top of high places by the way,
where the paths meet, she stands.
Beside the gates, at the entry of the city,
at the entry doors, she cries aloud:
“I call to you men!
I send my voice to the sons of mankind.
You simple, understand prudence!
You fools, be of an understanding heart!
Questions to consider
- What is Wisdom doing? Why?
- Where is she calling out?
- Who is she calling out to?
- What does naive mean?
- (of a person or action) showing a lack of experience, wisdom, or judgment
- What does prudence mean?
- acting with or showing care and thought for the future
This year Daddy wants to study the Proverbs together. Why? Because I want you children to be wise and not foolish. A wise man or woman will be protected and will be a blessing to everyone around him. But a foolish man will destroy himself and the people closest to him.
God has given us this book of Proverbs to teach us how to be wise. So we should read it and study it carefully.
Monday, August 17, 2020
2.2 Proverbs 8:6-11
Hear, for I will speak excellent things.
The opening of my lips is for right things.
For my mouth speaks truth.
Wickedness is an abomination to my lips.
All the words of my mouth are in righteousness.
There is nothing crooked or perverse in them.
They are all plain to him who understands,
right to those who find knowledge.
Receive my instruction rather than silver,
knowledge rather than choice gold.
For wisdom is better than rubies.
All the things that may be desired can’t be compared to it.
Questions to consider
- Why do we have to be told to listen? Do we like to hear the truth?
- Can you be good without telling the truth? Can you tell the truth and be wicked?
- What is the difference between wisdom and knowledge?
- How valuable is the truth? How valuable is wisdom?
We must be exhorted to listen because we don’t want to.  Some people whant to separate goodness from truthfulness. They say you can speak lies but still be good. That’s a lie. God is Righteous and True. There is no separating those two characteristics with Him.
Tuesday, August 18, 2020
2.3 Proverbs 8:12-13
12 “I, wisdom, have made prudence my dwelling.
Find out knowledge and discretion.
13 The fear of Yahweh is to hate evil.

Questions to consider
- What does prudence mean, again?
- Remember that prudence means, acting with or showing care and thought for the future.
- We had a conversation yesterday about the importance of delayed gratification. What does delayed gratification have to do with prudence?
- What does it mean for wisdom to have a home in “prudence?”
- What does discretion mean? Why is it important?
- Discretion means acting or speaking in a way that avoids causing offense or revealing private information.
- What things do you hate?
 Or do you have have to learn to hate evil?
- What is the fear of the Lord/Yahweh? Why is does hating evil show that you fear the Lord?
- What does God hate?
To learn wisdom, we must learn all three things: how to think, how to talk, and how to act. We must have our emotions trained as well as our minds. There is no separating the two of them, no matter how hard we might try.
Wednesday, August 19, 2020
2.4 Proverbs 8:14-21
14 Counsel and sound knowledge are mine.
I have understanding and power.
15 By me kings reign,
and princes decree justice.
16 By me princes rule,
nobles, and all the righteous rulers of the earth.
17 I love those who love me.
Those who seek me diligently will find me.
18 With me are riches, honor,
enduring wealth, and prosperity.
19 My fruit is better than gold, yes, than fine gold,
my yield than choice silver.
20 I walk in the way of righteousness,
in the middle of the paths of justice,
21 that I may give wealth to those who love me.
I fill their treasuries.
Questions to consider
It has been a few days since we started this chapter, so let’s try to remember a few things:
- Who is speaking in this chapter, Proverbs chapter 8?
- Why is she speaking? Generally, what is she trying to say?
- Lady wisdom claims to have many things in these verses. Can you tell me what some of them are?
- So does wisdom help you get to heaven, or does it just help you gain riches and wealth here on earth? (hint: that’s a bad question…)
- Have you ever heard of the “health and wealth gospel?” What is it? What does that phrase mean?
If we are wise, we can usually expect the fruit of our work and life to be good - both here on earth and on heaven. But an essential part of wisdom is to not confuse the blessings of this life with the final blessings of heaven.
Thursday, August 20, 2020
2.5 Proverbs 8:22-31
22 “Yahweh possessed me in the beginning of his work,
before his deeds of old.
23 I was set up from everlasting, from the beginning,
before the earth existed.
24 When there were no depths, I was born,
when there were no springs abounding with water.
25 Before the mountains were settled in place,
before the hills, I was born;
26 while as yet he had not made the earth, nor the fields,
nor the beginning of the dust of the world.
27 When he established the heavens, I was there.
When he set a circle on the surface of the deep,
28 when he established the clouds above,
when the springs of the deep became strong,
29 when he gave to the sea its boundary,
that the waters should not violate his commandment,
when he marked out the foundations of the earth,
30 then I was the craftsman by his side.
I was a delight day by day,
always rejoicing before him,
31 rejoicing in his whole world.
My delight was with the sons of men.
Questions to consider
- When did God create wisdom?
- Why is it important that wisdom came before everything else?
- It shows that wisdom is more foundational, important and essential. Wisdom has authority - it has a right to speak.
- Matthew Henry thinks that Solomon is referring to Jesus Christ here. As it says in 1 Cor. 1:24: “…but to those who are called, both Jews and Greeks, Christ is the power of God and the wisdom of God;”
Friday, August 21, 2020
2.6 Proverbs
Monday, August 24, 2020
2.7 Proverbs 2:1-5
1 My son, if you will receive my words,
and store up my commandments within you,
2 so as to turn your ear to wisdom,
and apply your heart to understanding;
3 yes, if you call out for discernment,
and lift up your voice for understanding;
4 if you seek her as silver,
and search for her as for hidden treasures;
5 then you will understand the fear of Yahweh,
and find the knowledge of God.
Tuesday, August 25, 2020 (Asher’s birthday)
2.8 Proverbs 4:14-19
14 Don’t enter into the path of the wicked.
Don’t walk in the way of evil men.
15 Avoid it, and don’t pass by it.
Turn from it, and pass on.
16 For they don’t sleep unless they do evil.
Their sleep is taken away, unless they make someone fall.
17 For they eat the bread of wickedness
and drink the wine of violence.
18 But the path of the righteous is like the dawning light
that shines more and more until the perfect day.
19 The way of the wicked is like darkness.
They don’t know what they stumble over.
Questions to consider
- Don’t walk here, walk here.
- Why wouldn’t someone be able to sleep until they do evil?
- Eat bread and drink wine… what does that remind you of? And what does communion signify?
- The righteous gets increasingly clear and bright.
- And darkness? Confusion?
Friday, August 28, 2020
2.9 Proverbs 1:1-6
1 The proverbs of Solomon, the son of David, king of Israel:
2 to know wisdom and instruction;
to discern the words of understanding;
3 to receive instruction in wise dealing,
in righteousness, justice, and equity;
4 to give prudence to the simple,
knowledge and discretion to the young man—
5 that the wise man may hear, and increase in learning;
that the man of understanding may attain to sound counsel;
6 to understand a proverb and parables,
the words and riddles of the wise.
2.10 Proverbs 1:8-9
8 My son, listen to your father’s instruction,
and don’t forsake your mother’s teaching;
9 for they will be a garland to grace your head,
and chains around your neck.
2.11 Proverbs 2:1-10
1 My son, if you will receive my words,
and store up my commandments within you,
2 so as to turn your ear to wisdom,
and apply your heart to understanding;
3 yes, if you call out for discernment,
and lift up your voice for understanding;
4 if you seek her as silver,
and search for her as for hidden treasures;
5 then you will understand the fear of Yahweh,
and find the knowledge of God.*
6 For Yahweh gives wisdom.
Out of his mouth comes knowledge and understanding.
7 He lays up sound wisdom for the upright.
He is a shield to those who walk in integrity,
8 that he may guard the paths of justice,
and preserve the way of his saints.
9 Then you will understand righteousness and justice,
equity and every good path.
10 For wisdom will enter into your heart.
Knowledge will be pleasant to your soul.
Questions to Consider:
- Who gives you instruction? Why is the instruction of your mother and father so important?
- What is a garland?
- Do you like hidden treasure? If you knew there was hidden treasure at the church, what would you do?
- What is the promise we have if we seek for wisdom? (That we will find it!) Where does wisdom come from?
- What is one of the benefits of having wisdom? (That our integrity and righteousness will protect us.)
- Is knowledge always pleasant to our souls? Why or why not?


Contact Us!
Please use this page to contact the administrator of the site.We will try to respons as quickly as possilbe!
Thanks,
Conor.
Or you can come find me in Dublin!
Here is a video of some great cycling in Ireland by introvertification on Youtube


{% extends 'base.html' %} {% block content %}
Collaboratively administrate turnkey channels whereas virtual e-tailers. Objectively seize scalable metrics whereas proactive e-services.