Can you see the editing possibilities, reverting to old version, protecting, watching the page, etc.? [[User:Cvr|CVR]]

My user id is made visible with the simple code of three consecutive tilde characters: <code><nowiki>~~~</nowiki></code>.

Talk:Marcia

2010-05-11T08:57:54Z

Cvr: New page: Can you see the editing possibilities, reverting to old version, protecting, watching the page, etc.? ~~~ My user id is made visible with the simple code of three consecutive tilde cha...

Marcia

2010-05-11T08:53:29Z

Cvr:

=<center>John Bunyan’s ''Pilgrim’s Progress'' (1678)</center>=

==Overview==

John Bunyan, a self-educated Puritan preacher, wrote his classic book ''The Pilgrim’s Progress from This World to That Which Is to Come'' Pilgrim’s Progress while he was in jail in 1675 for refusing to conform to the tenets of the official Church of England. The book, an allegory describing the journey of a Christian from this world to the next, gives a vivid picture of the religious beliefs of Bunyan and other Nonconformists, who rejected the teaching of the State state Churchchurch. In the first part of ''Pilgrim’s Progress'', written originally to stand alone, Christian, the titular hero, becomes increasingly convinced that he and his community are under a sentence of judgment. Unable to persuade anyone else to flee destruction with him, he sets off alone on a journey to salvation. The second part tells the story of Christian’s wife, Christiana, and their children making on the same difficult journey.

''Pilgrim’s Progress'', first published in 1678, is a Puritan sermon in the form of a novel, using powerful and charming storytelling to teach the lesson that the world is the venue for the battle of spiritual forces and that victory only comes only through denying the world to seek salvation. Bunyan’s writings, of which ''Pilgrim’s Progress'' is far and away the best known, allowed him to reach a huge audience despite his incarceration. His account of a religious “everyman” made him a celebrity in his own day and has inspired countless tracking people ever since.

==Context==

The English Civil War, a series of three armed conflicts (1641–1651), pitted not only Cavaliers (supporters of the king) against Roundheads (supporters of Parliament), or believers in divine right absolutist monarchy by divine right against those who championed some form of constitutional government, it also pitted the official Anglican religious settlement against the religion of the Puritans (Protestants who preferred a more rigorous and Bible-centered faith). Nonconformists, or Dissenters, as Puritans who rejected the Anglican Church were known, formed the backbone of the parliamentary armies led by Oliver Cromwell, which eventually overthrew the monarchy. During the Commonwealth (1649–1660), while Oliver Cromwell ruled as lord protector,[AuQ1] Dissenters were free to practice their religion as they chose. I have added this sentence to this page, just to show the tracking possibilities.

After Cromwell’s death, England welcomed back Charles II (r. 1660–1685) and, with him, a renewed Anglican settlement. The Restoration government moved quickly and severely against Dissenters, demanding full allegiance to the State ChurchChurch of England, or the Anglican Church. Official Anglicanism had wealth, resources, facilities, and educated clergy. Dissenting churches made do without any of these advantages, and the costs of resistance were high enough that the most Dissenters were drawn from the uneducated and poor working classes. Some became involved in political schemes to overthrow Charles or, later, his brother James II (r. 1685–1688). Eventually Dissenters would play a prominent role in ousting the Catholic James for the Protestant Mary and her Dutch Protestant husband William in the Glorious Revolution of 1688. Other Dissenters would leave England for places of refuge such as the New World (as the Pilgrims had done before the English Civil War). But most remained at home and avoided politics as best they could, worshiping according to their beliefs and living with the consequences.

John Bunyan participated personally in the all the great happenings of his time. Although he was not yet a committed Puritan, as a teenager he served in the Parliamentary army toward the end of the English Civil War. Later, during the Commonwealth, he experienced his conversion, and used the freedom of that era to become a Dissenting preacher. Like many other Noncomformists, he experienced persecution under the Restoration government. Bunyan himself spent more than twelve years in jail for preaching without a license. He died just before England’s Glorious Revolution allowed some measure of freedom to those who shared his religious beliefs. Yet the ideas about faith he taught in ''Pilgrim’s Progress'', along with the general English experience on Nonconformity, would contribute toward shaping English views about freedom, government, and the intersection of church and state, not only in Britain but in the United States as well.

==Time Line==

*November 30, 1628—John Bunyan is born in Harrowden in Bedfordshire, Elstow, England.
*1649—The end of the Second English Civil War ushers in the Commonwealth.
*1653—Bunyan experiences a conversion and is baptized and received into the Baptist Church.
*1657—Bunyan begins his career as a preacher.
*1660—The end of the Commonwealth brings about the Restoration under Charles II.
*1660—Bunyan is imprisoned for the first time in Bedford Jail, a confinement that lasts until 1672.
*1666—Bunyan writes his autobiography, ''Grace Abounding to the Chief of Sinners''.
*1675—Bunyan is imprisoned for the second time in Bedford Jail, where he writes ''Pilgrim’s Progress''.
*1678—''Pilgrim’s Progress'' is published.
*1682—''The Holy War'' is published.
*1684—The second part of ''Pilgrim’s Progress'' is published.
*1685—Charles II dies, and James II ascends to the throne.
*August 31, 1688—Bunyan dies.
*1688—The Glorious Revolution brings William and Mary to the throne and establishes limited religious freedom for Dissenters.
*1692—Bunyan’s last work, the anti-Catholic ''Of Antichrist and Her His Ruin'' is published.[AuQ2]

==About the Author==

The English writer and preacher John Bunyan was born in Harrowden in the county of Bedfordshire on November 30, 1628, to an extremely poor family. He received only a minimal education and followed his father into trade as a tinker before he went on to serve in the Parliamentary army during the English Civil War. It was his marriage after the end of military service that changed Bunyan’s life. His wife brought as her only dowry two religious texts. Reading those books brought focused Bunyan’s thoughts increasingly onto his own spiritual condition and eventually led to what he recognized as a conversion in 1653. A handful of other books, particularly the Bible, the Anglican ''Book of Common Prayer'', and John Foxe’s account of the Christian martyrs through history, ''Actes and Monuments'' (more commonly known as ''The Book of Martyrs), played an important role in Bunyan’s self-education. In 1653 he was baptized and received into the Baptist Church. [AuQ3]

Bunyan’s faith took a public role in religious matters when he began to dispute with local Quakers in 1656; this led to increasing involvement in ministry and finally a call to serve a local Independent cCongregation as pastor.[AuQ4] Under the Commonwealth it was possible for self-proclaimed preachers to lead congregations. With the Restoration of both Charles II and the Anglican Church, however, the government began to move against unlicensed preachers. Bunyan refused to conform to the Church of England and was jailed in 1660. His first period of imprisonment lasted (with occasional interruptions) for twelve years. The confinement was lax, giving him opportunities to write. It was probably during this period that Bunyan began to plan ''Pilgrim’s Progress'', though he did not begin the writing process until later—certainly he was busy enough turning out his autobiography (''Grace Abounding to the Chief of Sinners'') and other books, pamphlets, sermons, and poetry.

Upon release, Bunyan immediately renewed his career as a pastor, serving a congregation until he was arrested and jailed again in 1675.[AuQ5] It was during the following brief stint in prison that he wrote the first part of ''Pilgrim’s Progress'', although the work was not published for three more years. In 1684 he published the second half of the work. Bunyan’s second jail term lasted only six months, and his increasing reputation and popularity protected him from further trouble. He was even offered royal patronage by James II, but Bunyan’s religious convictions caused him to refuse the post. He continued writing and preaching up until his death on August 31, 1688.

==Explanation and Analysis of the Document==

[AuQ6]

===As I Walked through the Wilderness of This World===

After an introduction in verse, Bunyan sets the stage for his story by describing it as the dream of the author; the author will not reawake until the final line of part 1. As a writer, Bunyan is known for his rich uses of imagery—imagery drawn heavily from the Authorized Version of the Bible. In this opening paragraph, for instance, the description of the future pilgrim is taken from scripture. “Filthy rags” are how the prophet Isaiah describes human attempts to please God; the Psalmist speaks of sins as a “heavy burden . . . too heavy for me.” Similarly, the despairing cry “What shall I do?” is an echo of several biblical passages. The sorrow, as the main character will soon relate, is a sense of impending judgment due for his own sins and the sins of his community. Such sorrow is a natural and appropriate response to encountering God’s truth, as the future pilgrim does when he reads his book (the Bible).

===In This Plight, Therefore, He Went Home===

Bunyan’s description of the future pilgrim’s dilemma is a reflection of the differing understandings of salvation promoted by the state church (Church of England/Anglicans) and Bunyan’s own beliefs. The Church of England did not see society itself under judgment, taught that salvation lay in taking one’s appropriate place in society, and emphasized the communal rather than the individual aspects of salvation. Furthermore, the path to salvation offered through the Anglican Church was seen as the default position for any in the community who did not specifically reject it—no one need worry too much about being saved. Independents and other Puritans like Bunyan, however, understood society to be at odds with God. Salvation came only through rejecting society and its religious values and committing one’s self entirely to God. Although Bunyan’s version of Puritanism had strong communal implications (in part 2 of ''Pilgrim’s Progress'', Christiana and her children travel together), there was an important individual component to religion. Underlying this stance was the assumption, in contrast to Anglicanism, that every person was lost ''unless'' he or she converted. The difference between the two positions is typical of a division in Western religiosity classified by sociologists as “church” versus “sect.”

The mocking and derision the future pilgrim experienced would have been very familiar to Bunyan’s audience. Bunyan himself was in jail when he wrote ''Pilgrim’s Progress'', and all Nonconformists faced significant penalties—socially, economically, and legally—for rejecting the state church in favor of their own religious beliefs. Adherence to a Dissenting congregation might even mean alienation from family and friends. It was this contempt that Puritans received from the world for their beliefs that strengthened the Puritan notion that the world itself was lost. Certainly the pressure to give up Dissenting beliefs and values taught the Puritans that the battles between good and evil over the destiny of souls were to be fought out in the world.

Bunyan has the first step in the journey to salvation begin with personal anguish. For Puritans, salvation required a strong sense of individual sin and unworthiness. Only those recognizing their sinfulness could turn to God for forgiveness and mercy. It was typical of Puritan values that a decision for conversion only followed many hours of reflection and consideration. While some of their modern-day heirs understand conversion as an instant, once-and-for-all occurrence, for Puritans it was a process involving time and multiple stages.

The phrase (odd to modern ears) “children of my bowels” reflects Bunyan’s own familiarity with the Authorized Version of the Bible. The original Greek of the New Testament does indeed use the word correctly translated in the Authorized Version as “bowels” to describe what modern translations render in different places as “heart” or “feeling.” Modern Western people usually make the heart the seat of human emotion. The ancients gave that role to the stomach. It is the stomach that receives the rush of acid, for instance, with some strong emotions or that churns with anxiety or hurts during times of stress. The main character is simply adapting a literary expression to describe how dear his children are to him.

===Now I Saw . . . [Him] Reading His Book, and Greatly Distressed in Mind===

The importance of reading in the main character’s conversion reflects Bunyan’s own experience—his conversion was prompted by two books of his wife’s. Of course, the book here in the story later proves to be the Bible, the chief source of inspiration for Bunyan, as for all good Puritans. But even these Bible-centered Protestants did not reject the help of other forms of literature. ''Pilgrim’s Progress'' itself was meant to be one of the books that helped Pilgrims on their way.

Evangelist is the first character to be introduced by name. In Bunyan’s story, the character of every person met in the pages is revealed by his or her name. Technically speaking, an Evangelist was one of the authors of the four Gospels (Matthew, Mark, Luke, and John), but Bunyan uses the name in the modern sense. Evangelist is someone who can tell the main character about salvation (“the Gospel” or “the Good News”). The future pilgrim has worked out his need for salvation on his own but requires someone to direct him on the path. Evangelist does not take him to salvation or plot the whole journey but merely points him in the right direction.

Notice that up to this point in the story the main character does not yet have a name. His character has not yet been defined. Only after he makes an important decision can his true nature be revealed by the name he is given. This encounter between Evangelist and the main character emphasizes the individualistic aspect of the Puritan understanding of salvation. To obtain eternal life, the pilgrim must be willing to leave other kinds of life (family life, public life) behind. Underlying Bunyan’s beliefs was the conviction that “the world” (society, community, the established order) was opposed to God’s will and a hindrance to salvation. One must choose between the world’s way and God’s way.

At the same time, Puritan religion was communal as well as individualistic. At some point each individual must make a personal decision, but such decisions are not made in isolation. There is no salvation for the main character with Evangelist to point the way. At critical times in the story other individuals will appear or reappear to keep the pilgrim on the path. The corporate nature of pilgrim life is emphasized more strongly in the second part of the book, where the pilgrims travel in a group.

The description of the meeting between Evangelist and the main character is a classic descriptiondepiction of Puritan values. Human sin and its deserved condemnation are self-obviousevident, and many people in the course of life might become aware of them. However, some who recognized their own faults and knew know they needed to be saved might, by society’s pressure, decide to ignore their convictions. It iswas only when the sense of sin iswas too strong to ignore that the individual iswas willing to pursue relief. The main character is at this point, not yet saved but a seeker after salvation. And to seek, he must leave his community behind.

===The Neighbors Also Came Out===

The decision to set out on the road to salvation was is a momentous one. Only now can the pilgrim be called by his appropriate name, Christian. While the state church would have claimed that all those living in the city of Destruction (which Christian has just fled) were Christians, for the Puritans real Christians were those who were aware of their own sin and who turned to God for salvation.

The experience of opposition was an important part of Puritan self-understanding. Since the world was lost and under judgment, one could expect only opposition from those who lived in it. In the case of Christian, there is general contempt and specific opposition from the characters Obstinate and Pliable. Obstinate questions the pilgrim, allowing Christian to describe something of his hope for salvation, words that only bring derision on “the book.” Obstinate calls for the pilgrim to give up his silliness and come home, while Pliable proves more open to the message. Ultimately Pliable resolves to travel with the pilgrim, while Obstinate turns back in disgust. It is probably not a good sign for Pliable’s future as a pilgrim that he is more attracted to the journey by the joys of heaven than by the conviction for of his own sin.

Bunyan’s short description of what the responses of Christian’s experiences from his neighbors hints at three types of opposition Nonconforming Christians experienced. The first was simple rejection, characterized by mockery—the sort of reaction Bunyan highlights in the story. The second, perhaps implied in the phrase “some cried after him to return,” was a more serious effort to convincepersuade Dissenters to abandon their peculiar religious ideas. Mr. Worldly Wiseman, who appears later in the reading, provides one example of this sort as he tries to talk Christian into losing his burden in Morality. The final type of opposition is implied in the attempt “to fetch him back by force.” The state church possessed great power from the government to compel conformity. Bunyan himself, of course, wrote ''Pilgrim’s Progress'' while he was in jail for preaching without a license, a license that never would have been issued to him. The amount of legal trouble Dissenters faced varied from place to place and time to time. There were districts and periods where Nonconformists were generally ignored, while on other occasions they might face strict persecution. Even after 1688, though, when the freedom of Protestants to worship was generally allowed, Nonconformists faced severe legal limitations in terms of careers and education. When Bunyan describes the world as actively hostile to Puritan Christians, he is doing no more than recounting a reality he and most Nonconformists experienced.

===Now I Saw in My Dream, That When Obstinate Was Gone Back===

Christian and Pliable travel together, while Christian gives more details about the glorious future awaiting believers in heaven. Their conversation demonstrates that the book Christian carries with him is indeed the Bible, a sure source of knowledge about spiritual realities. Although Christian is eager to hurry down the path to the Heavenly City, he finds himself slowed by the burden of sin he still carries on his back like a pack.

The “Slough of Despond” is one of Bunyan’s most famous images. Like that of any good allegorical figure, its rich complexity defies simple characterization, but among other things it is a swamp that traps people who are beginning their pilgrimage to the Heavenly City. The Slough itself stains and defiles, and in it the weight of sin is even more burdensome. It is ultimately revealed that the swamp is created from the discouragement that attends an awareness of personal sin. Although it is a trap or hazard on the path to salvation, it is one that cannot be completely mended, because the sorrow and fear created by an awareness of sin is natural (and even necessary) for those seeking to escape judgment.

Even if the Slough cannot ever be entirely drained, it should not be the great obstacle that it is. Here Bunyan is making a typical Puritan complaint against both the Catholic Church and the Anglican Church. Like a monarch ordering his highways to be maintained, God had commanded the road through the Slough to be repaired and provided much teaching to help Christians avoid being caught in the swamp of discouragement and self-doubt, yet these lessons had been mishandled, leaving many stuck in the mire. With appropriate instruction, a believer should be able to find God’s firm path through the dangerous slough. This is the fault of the state church, which neglects its essential functions and fails to teach important truths to its adherents, leaving pilgrims to find their own way down the difficult road to salvation.

Despite the hardships, Christian fights his way through the swamp, with the aid of the character Help—yet another reminder of the corporate aspect of Puritan faith. Christian needs others to give him a hand up from the swamp and to point him to the right path. and continues on his way. But Pliable, who before was so eager to experience the joys of the Heavenly City, is overwhelmed by the challenges of the journey and turns away. Christian continues on his way. The character Help is yet another reminder of the corporate aspect of Puritan faith. Christian needs others to give him a hand up from the swamp and to point him on the right way.

===Now I Saw in My Dream That by This Time Pliable Was Got Home===

Bunyan’s audience would have been very familiar with individuals who had temporarily associated themselves with Dissenting congregations and then returned to the state church. The story of Pliable served as a cautionary tale. Those who went back to their old ways were likely to get just as much grief from their neighbors as if they had remained true, yet they would also miss out on heaven. In fact, since Pliable is around to be derided by his neighbors while Christian has moved on, Pliable may be even be worse off in the present life, just as he will certainly be worse off in the future one.

===Now As Christian Was Walking Solitary===

Christian continues on his journey and encounters a new figure, a man who hasd advice for him. The pilgrim has set out on the road to the Heavenly City in order to have the burden lifted from his back. Mr. Worldly Wiseman suggests that there are easier ways to remove the burden, ways that do not involve hardship, danger, or the loss of his family and community standing.

From a Puritan perspective, images of morality and civility promoted by society and the Church of England were traps. As Puritans understood the Bible, human effort (“keeping the law”) was unable tocould not save people from God’s judgment. To them, much of what the state church offered was a reliance on human effort, helping people to feel better about themselves so that they no longer noticed their burden of sin but not actually providing salvation. The Puritans saw such teaching as a medicine that masked a patient’s symptoms without curing the deadly disease. In rejecting “morality,” the Puritans were not advocating wild, sinful lifestyles—after all, Puritanism today is a byword for ultrastrict conduct. Instead, they were rejecting “moralism,” the idea that avoiding certain conspicuous sins was enough to please God. Civility was an even greater trap, elevating politeness and deference to society’s ideals of appropriate public behavior as the ultimate standard of human conduct.

Mr. Worldly Wiseman mocks both the teaching of “the book” and Christian’s efforts to understand it. The warning not to meddle in things too high for him was typical of the advice that often uneducated Dissenters might frequently receive. Many educated people believed that only the trained experts of the state church were competent to interpret the Bible and God’s will and found it offensive that less-educated and less-qualified people would presume to do so. Although it was not necessarily true of the first generation of Puritans, there was an increasing element of class division between Dissenters and the supporters of the established church. This division would grow with time, so that most Nonconforming English groups (Congregationalists, Presbyterians, Baptists, and later Methodists), would be firmly working-class in orientation.

For Bunyan, socially acceptable alternatives to fleeing the City of Destruction were foolish tricks. The burden of sin was a real problem pointing to a real solution, and any alleged “cure” that caused a would-be pilgrim to forsake the journey to salvation was a terrible lie. Christian is taken in and leaves the correct road for a dead-end path. Even though the difficult way of salvation is full of misleading tracks, it is always possible to get back on the right road.

===So Christian Turned Out of His Way===[AuQ7]

The way of morality and civility seemed to offer an attractive short-cut to relief from the burden of sin, yet as Christian tries to go that direction, he finds the burden of sin growing and the path actually more difficultharder to follow. Trying to lead a genuinely moral life proves to be more difficult than it seemed initially, and is unable todoes not lead to salvation. Poor Christian despairs of ever reaching the Heavenly City. However, even though his sins are great, it is possible for him to return to the true path.

===Now Christian Looked for Nothing but Death===

Poor Christian despairs of ever reaching the Heavenly City. However, even though his sins are great, it is possible for him to return to the true path.

==Audience==

Bunyan wrote for the sorts of people who attended or were likely to attend congregations not affiliated with the Church of England. Such Dissenters might lack formal education but often knew the Bible well and were familiar, through sermons, with many of the types of imagery Bunyan employed in ''Pilgrim’s Progress''. The book was aimed both at those considering conversion and Christians who needed encouragement to remain faithful.

For many years ''Pilgrim’s Progress'' was appreciated as a classic work of English literature. Most English-language readers encounter it today only in the classroom, but Bunyan’s work still reaches an audience through other authors who have incorporated his values and ideas. Today ''Pilgrim’s Progress'' remains widely read as a religious work, particularly by Protestants of almost all denominations. Modern Christians particularly appreciate Bunyan’s theological understanding of discouragement as a natural part of faith. The text is also still used by Christian missionaries as a way to introduce Protestant beliefs about conversion and salvation.

==Impact==

It is often said that, after the Bible, ''Pilgrim’s Progress'' iswas the most printed, published, and translated book in the world. (It appeared in ninety different editions in the first hundred years after its publication and has been translated into more than two hundred languages.) Certainly it was the top best-seller in premodern England and enjoyed a similar popularity in colonial America. For generations Bunyan’s allegory was the most popular religious text in the English-speaking world.

Although Bunyan’s literary reputation has somewhat diminished in modern times, it was not only his religious views that were influential. Readers who passed over the spiritual message of ''Pilgrim’s Progress'' were often affected by Bunyan’s powerful and creative literary style. Bunyan’s influence extends even over those who reject his basic values or have never read his work—the popular magazine ''Vanity Fair'' takes its name from a large community’s market in ''Pilgrim’s Progress'', for Bunyan a place of temptation to avoid. Another of many of Bunyan’s phrases to enter popular culture is “Slough of Despond.”

As an author, Bunyan still continues to exert influence. C. S. Lewis, the author of the Narnia stories and a popular Christian writer, was inspired by Bunyan to write a modern Christian allegory, which he entitled ''The Pilgrim’s Regress''. ''Pilgrim’s Progress'' had a discernable impact on such classic literature as Charlotte Brontë’s ''Jane Eyre'', Louisa May Alcott’s ''Little Women'', and Kurt Vonnegut’s ''Slaughterhouse-Five'', and, of course, William Makepiece Makepeace Thackeray’s ''Vanity Fair'', as well as dozens of lesser-known modern works. It was made into an opera by Ralph Vaughan Williams and more recently into a rock opera.

More important to Bunyan would have been the religious legacy of his writing. When Bunyan wrote his classic work, he was expressing the values of a persecuted minority. With time, however, and certainly helped by the wide popularity of ''Pilgrim’s Progress'', Puritan beliefs became more and more mainstream, until today many of their convictions are widely held in the Protestant community worldwide. Bunyan’s understanding of conversion, of Christian mistrust of society, of the role of the individual, and of the authority of scripture are shared by the majority of Christians in Britain and the United States today. Perhaps the greatest testimony to how widely accepted ''Pilgrim’s Progress'' is by modern Christians is the inclusion of Christian’s hymn “He Who Would Valiant Be” in the Church of England hymnal.

==Essential Quotes==

“He answered, ‘Sir, I perceive, by the book in my hand, that I am condemned to die, and after that to come to judgment; and I find that I am not willing to do the first, nor able to do the second’” (chapter 1, paragraph 4).

“So I saw in my dream that the man began to run. Now he had not run far from his own door when his wife and children, perceiving it, began to cry after him to return; but the man put his fingers in his ears, and ran on crying, Life! life! eternal life!”(chapter 1, paragraph 8).

“So Christian turned out of his way to go to Mr. Legality’s house for help: but, behold, when he was got now hard by the hill, it seemed so high, and also that side of it that was next the way-side did hang so much over, that Christian was afraid to venture further, lest the hill should fall on his head; wherefore there he stood still, and wotted not what to do. Also his burden now seemed heavier to him than while he was in his way” (chapter 1, paragraph 80).

=Further Reading=

===Articles===

#Dutton, Richard A. “‘Interesting, but Tough’: Reading The Pilgrim’s Progress”. ''Studies in English Literature''18, no. 3 (Summer 1978): 439–456.

===Books===

#Bunyan, John. ''Grace Abounding to the Chief of Sinners''. New York: Penguin, 1987.
#Furlong, Monica. ''Puritan’s Progress: A Study of John Bunyan''. London: Hodder & Stoughton, 1975.
#Greaves, Richard L. ''Glimpses of Glory: John Bunyan and English Dissent''. Standford, Calif.: Stanford University Press, 2002.
#Hill, Christopher. ''A Tinker and a Poor Man: John Bunyan and His Church, 1628–1688''. New York: Knopf, 1988.
#Mullett, Michael. ''John Bunyan in Context''. Keele, U.K.: Keele University Press, 1996.
#Vincent Newey, ed. ''The Pilgrim’s Progress: Critical and Historical Views''. Liverpool, U.K.: University of Liverpool Press, 1980.
#Winslow, Ola Elizabeth. ''John Bunyan''. New York: Macmillan, 1961.  

—Raymond Powell

Marcia

2010-05-11T08:51:36Z

Cvr: New page: =<center>John Bunyan’s ''Pilgrim’s Progress'' (1678)</center>= ==Overview== John Bunyan, a self-educated Puritan preacher, wrote his classic book ''The Pilgrim’s Progress from Thi...

=<center>John Bunyan’s ''Pilgrim’s Progress'' (1678)</center>=

==Overview==

John Bunyan, a self-educated Puritan preacher, wrote his classic book ''The Pilgrim’s Progress from This World to That Which Is to Come'' Pilgrim’s Progress while he was in jail in 1675 for refusing to conform to the tenets of the official Church of England. The book, an allegory describing the journey of a Christian from this world to the next, gives a vivid picture of the religious beliefs of Bunyan and other Nonconformists, who rejected the teaching of the State state Churchchurch. In the first part of ''Pilgrim’s Progress'', written originally to stand alone, Christian, the titular hero, becomes increasingly convinced that he and his community are under a sentence of judgment. Unable to persuade anyone else to flee destruction with him, he sets off alone on a journey to salvation. The second part tells the story of Christian’s wife, Christiana, and their children making on the same difficult journey.

''Pilgrim’s Progress'', first published in 1678, is a Puritan sermon in the form of a novel, using powerful and charming storytelling to teach the lesson that the world is the venue for the battle of spiritual forces and that victory only comes only through denying the world to seek salvation. Bunyan’s writings, of which ''Pilgrim’s Progress'' is far and away the best known, allowed him to reach a huge audience despite his incarceration. His account of a religious “everyman” made him a celebrity in his own day and has inspired countless people ever since.

==Context==

The English Civil War, a series of three armed conflicts (1641–1651), pitted not only Cavaliers (supporters of the king) against Roundheads (supporters of Parliament), or believers in divine right absolutist monarchy by divine right against those who championed some form of constitutional government, it also pitted the official Anglican religious settlement against the religion of the Puritans (Protestants who preferred a more rigorous and Bible-centered faith). Nonconformists, or Dissenters, as Puritans who rejected the Anglican Church were known, formed the backbone of the parliamentary armies led by Oliver Cromwell, which eventually overthrew the monarchy. During the Commonwealth (1649–1660), while Oliver Cromwell ruled as lord protector,[AuQ1] Dissenters were free to practice their religion as they chose.

After Cromwell’s death, England welcomed back Charles II (r. 1660–1685) and, with him, a renewed Anglican settlement. The Restoration government moved quickly and severely against Dissenters, demanding full allegiance to the State ChurchChurch of England, or the Anglican Church. Official Anglicanism had wealth, resources, facilities, and educated clergy. Dissenting churches made do without any of these advantages, and the costs of resistance were high enough that the most Dissenters were drawn from the uneducated and poor working classes. Some became involved in political schemes to overthrow Charles or, later, his brother James II (r. 1685–1688). Eventually Dissenters would play a prominent role in ousting the Catholic James for the Protestant Mary and her Dutch Protestant husband William in the Glorious Revolution of 1688. Other Dissenters would leave England for places of refuge such as the New World (as the Pilgrims had done before the English Civil War). But most remained at home and avoided politics as best they could, worshiping according to their beliefs and living with the consequences.

John Bunyan participated personally in the all the great happenings of his time. Although he was not yet a committed Puritan, as a teenager he served in the Parliamentary army toward the end of the English Civil War. Later, during the Commonwealth, he experienced his conversion, and used the freedom of that era to become a Dissenting preacher. Like many other Noncomformists, he experienced persecution under the Restoration government. Bunyan himself spent more than twelve years in jail for preaching without a license. He died just before England’s Glorious Revolution allowed some measure of freedom to those who shared his religious beliefs. Yet the ideas about faith he taught in ''Pilgrim’s Progress'', along with the general English experience on Nonconformity, would contribute toward shaping English views about freedom, government, and the intersection of church and state, not only in Britain but in the United States as well.

==Time Line==

*November 30, 1628—John Bunyan is born in Harrowden in Bedfordshire, Elstow, England.
*1649—The end of the Second English Civil War ushers in the Commonwealth.
*1653—Bunyan experiences a conversion and is baptized and received into the Baptist Church.
*1657—Bunyan begins his career as a preacher.
*1660—The end of the Commonwealth brings about the Restoration under Charles II.
*1660—Bunyan is imprisoned for the first time in Bedford Jail, a confinement that lasts until 1672.
*1666—Bunyan writes his autobiography, ''Grace Abounding to the Chief of Sinners''.
*1675—Bunyan is imprisoned for the second time in Bedford Jail, where he writes ''Pilgrim’s Progress''.
*1678—''Pilgrim’s Progress'' is published.
*1682—''The Holy War'' is published.
*1684—The second part of ''Pilgrim’s Progress'' is published.
*1685—Charles II dies, and James II ascends to the throne.
*August 31, 1688—Bunyan dies.
*1688—The Glorious Revolution brings William and Mary to the throne and establishes limited religious freedom for Dissenters.
*1692—Bunyan’s last work, the anti-Catholic ''Of Antichrist and Her His Ruin'' is published.[AuQ2]

==About the Author==

The English writer and preacher John Bunyan was born in Harrowden in the county of Bedfordshire on November 30, 1628, to an extremely poor family. He received only a minimal education and followed his father into trade as a tinker before he went on to serve in the Parliamentary army during the English Civil War. It was his marriage after the end of military service that changed Bunyan’s life. His wife brought as her only dowry two religious texts. Reading those books brought focused Bunyan’s thoughts increasingly onto his own spiritual condition and eventually led to what he recognized as a conversion in 1653. A handful of other books, particularly the Bible, the Anglican ''Book of Common Prayer'', and John Foxe’s account of the Christian martyrs through history, ''Actes and Monuments'' (more commonly known as ''The Book of Martyrs), played an important role in Bunyan’s self-education. In 1653 he was baptized and received into the Baptist Church. [AuQ3]

Bunyan’s faith took a public role in religious matters when he began to dispute with local Quakers in 1656; this led to increasing involvement in ministry and finally a call to serve a local Independent cCongregation as pastor.[AuQ4] Under the Commonwealth it was possible for self-proclaimed preachers to lead congregations. With the Restoration of both Charles II and the Anglican Church, however, the government began to move against unlicensed preachers. Bunyan refused to conform to the Church of England and was jailed in 1660. His first period of imprisonment lasted (with occasional interruptions) for twelve years. The confinement was lax, giving him opportunities to write. It was probably during this period that Bunyan began to plan ''Pilgrim’s Progress'', though he did not begin the writing process until later—certainly he was busy enough turning out his autobiography (''Grace Abounding to the Chief of Sinners'') and other books, pamphlets, sermons, and poetry.

Upon release, Bunyan immediately renewed his career as a pastor, serving a congregation until he was arrested and jailed again in 1675.[AuQ5] It was during the following brief stint in prison that he wrote the first part of ''Pilgrim’s Progress'', although the work was not published for three more years. In 1684 he published the second half of the work. Bunyan’s second jail term lasted only six months, and his increasing reputation and popularity protected him from further trouble. He was even offered royal patronage by James II, but Bunyan’s religious convictions caused him to refuse the post. He continued writing and preaching up until his death on August 31, 1688.

==Explanation and Analysis of the Document==

[AuQ6]

===As I Walked through the Wilderness of This World===

After an introduction in verse, Bunyan sets the stage for his story by describing it as the dream of the author; the author will not reawake until the final line of part 1. As a writer, Bunyan is known for his rich uses of imagery—imagery drawn heavily from the Authorized Version of the Bible. In this opening paragraph, for instance, the description of the future pilgrim is taken from scripture. “Filthy rags” are how the prophet Isaiah describes human attempts to please God; the Psalmist speaks of sins as a “heavy burden . . . too heavy for me.” Similarly, the despairing cry “What shall I do?” is an echo of several biblical passages. The sorrow, as the main character will soon relate, is a sense of impending judgment due for his own sins and the sins of his community. Such sorrow is a natural and appropriate response to encountering God’s truth, as the future pilgrim does when he reads his book (the Bible).

===In This Plight, Therefore, He Went Home===

Bunyan’s description of the future pilgrim’s dilemma is a reflection of the differing understandings of salvation promoted by the state church (Church of England/Anglicans) and Bunyan’s own beliefs. The Church of England did not see society itself under judgment, taught that salvation lay in taking one’s appropriate place in society, and emphasized the communal rather than the individual aspects of salvation. Furthermore, the path to salvation offered through the Anglican Church was seen as the default position for any in the community who did not specifically reject it—no one need worry too much about being saved. Independents and other Puritans like Bunyan, however, understood society to be at odds with God. Salvation came only through rejecting society and its religious values and committing one’s self entirely to God. Although Bunyan’s version of Puritanism had strong communal implications (in part 2 of ''Pilgrim’s Progress'', Christiana and her children travel together), there was an important individual component to religion. Underlying this stance was the assumption, in contrast to Anglicanism, that every person was lost ''unless'' he or she converted. The difference between the two positions is typical of a division in Western religiosity classified by sociologists as “church” versus “sect.”

The mocking and derision the future pilgrim experienced would have been very familiar to Bunyan’s audience. Bunyan himself was in jail when he wrote ''Pilgrim’s Progress'', and all Nonconformists faced significant penalties—socially, economically, and legally—for rejecting the state church in favor of their own religious beliefs. Adherence to a Dissenting congregation might even mean alienation from family and friends. It was this contempt that Puritans received from the world for their beliefs that strengthened the Puritan notion that the world itself was lost. Certainly the pressure to give up Dissenting beliefs and values taught the Puritans that the battles between good and evil over the destiny of souls were to be fought out in the world.

Bunyan has the first step in the journey to salvation begin with personal anguish. For Puritans, salvation required a strong sense of individual sin and unworthiness. Only those recognizing their sinfulness could turn to God for forgiveness and mercy. It was typical of Puritan values that a decision for conversion only followed many hours of reflection and consideration. While some of their modern-day heirs understand conversion as an instant, once-and-for-all occurrence, for Puritans it was a process involving time and multiple stages.

The phrase (odd to modern ears) “children of my bowels” reflects Bunyan’s own familiarity with the Authorized Version of the Bible. The original Greek of the New Testament does indeed use the word correctly translated in the Authorized Version as “bowels” to describe what modern translations render in different places as “heart” or “feeling.” Modern Western people usually make the heart the seat of human emotion. The ancients gave that role to the stomach. It is the stomach that receives the rush of acid, for instance, with some strong emotions or that churns with anxiety or hurts during times of stress. The main character is simply adapting a literary expression to describe how dear his children are to him.

===Now I Saw . . . [Him] Reading His Book, and Greatly Distressed in Mind===

The importance of reading in the main character’s conversion reflects Bunyan’s own experience—his conversion was prompted by two books of his wife’s. Of course, the book here in the story later proves to be the Bible, the chief source of inspiration for Bunyan, as for all good Puritans. But even these Bible-centered Protestants did not reject the help of other forms of literature. ''Pilgrim’s Progress'' itself was meant to be one of the books that helped Pilgrims on their way.

Evangelist is the first character to be introduced by name. In Bunyan’s story, the character of every person met in the pages is revealed by his or her name. Technically speaking, an Evangelist was one of the authors of the four Gospels (Matthew, Mark, Luke, and John), but Bunyan uses the name in the modern sense. Evangelist is someone who can tell the main character about salvation (“the Gospel” or “the Good News”). The future pilgrim has worked out his need for salvation on his own but requires someone to direct him on the path. Evangelist does not take him to salvation or plot the whole journey but merely points him in the right direction.

Notice that up to this point in the story the main character does not yet have a name. His character has not yet been defined. Only after he makes an important decision can his true nature be revealed by the name he is given. This encounter between Evangelist and the main character emphasizes the individualistic aspect of the Puritan understanding of salvation. To obtain eternal life, the pilgrim must be willing to leave other kinds of life (family life, public life) behind. Underlying Bunyan’s beliefs was the conviction that “the world” (society, community, the established order) was opposed to God’s will and a hindrance to salvation. One must choose between the world’s way and God’s way.

At the same time, Puritan religion was communal as well as individualistic. At some point each individual must make a personal decision, but such decisions are not made in isolation. There is no salvation for the main character with Evangelist to point the way. At critical times in the story other individuals will appear or reappear to keep the pilgrim on the path. The corporate nature of pilgrim life is emphasized more strongly in the second part of the book, where the pilgrims travel in a group.

The description of the meeting between Evangelist and the main character is a classic descriptiondepiction of Puritan values. Human sin and its deserved condemnation are self-obviousevident, and many people in the course of life might become aware of them. However, some who recognized their own faults and knew know they needed to be saved might, by society’s pressure, decide to ignore their convictions. It iswas only when the sense of sin iswas too strong to ignore that the individual iswas willing to pursue relief. The main character is at this point, not yet saved but a seeker after salvation. And to seek, he must leave his community behind.

===The Neighbors Also Came Out===

The decision to set out on the road to salvation was is a momentous one. Only now can the pilgrim be called by his appropriate name, Christian. While the state church would have claimed that all those living in the city of Destruction (which Christian has just fled) were Christians, for the Puritans real Christians were those who were aware of their own sin and who turned to God for salvation.

The experience of opposition was an important part of Puritan self-understanding. Since the world was lost and under judgment, one could expect only opposition from those who lived in it. In the case of Christian, there is general contempt and specific opposition from the characters Obstinate and Pliable. Obstinate questions the pilgrim, allowing Christian to describe something of his hope for salvation, words that only bring derision on “the book.” Obstinate calls for the pilgrim to give up his silliness and come home, while Pliable proves more open to the message. Ultimately Pliable resolves to travel with the pilgrim, while Obstinate turns back in disgust. It is probably not a good sign for Pliable’s future as a pilgrim that he is more attracted to the journey by the joys of heaven than by the conviction for of his own sin.

Bunyan’s short description of what the responses of Christian’s experiences from his neighbors hints at three types of opposition Nonconforming Christians experienced. The first was simple rejection, characterized by mockery—the sort of reaction Bunyan highlights in the story. The second, perhaps implied in the phrase “some cried after him to return,” was a more serious effort to convincepersuade Dissenters to abandon their peculiar religious ideas. Mr. Worldly Wiseman, who appears later in the reading, provides one example of this sort as he tries to talk Christian into losing his burden in Morality. The final type of opposition is implied in the attempt “to fetch him back by force.” The state church possessed great power from the government to compel conformity. Bunyan himself, of course, wrote ''Pilgrim’s Progress'' while he was in jail for preaching without a license, a license that never would have been issued to him. The amount of legal trouble Dissenters faced varied from place to place and time to time. There were districts and periods where Nonconformists were generally ignored, while on other occasions they might face strict persecution. Even after 1688, though, when the freedom of Protestants to worship was generally allowed, Nonconformists faced severe legal limitations in terms of careers and education. When Bunyan describes the world as actively hostile to Puritan Christians, he is doing no more than recounting a reality he and most Nonconformists experienced.

===Now I Saw in My Dream, That When Obstinate Was Gone Back===

Christian and Pliable travel together, while Christian gives more details about the glorious future awaiting believers in heaven. Their conversation demonstrates that the book Christian carries with him is indeed the Bible, a sure source of knowledge about spiritual realities. Although Christian is eager to hurry down the path to the Heavenly City, he finds himself slowed by the burden of sin he still carries on his back like a pack.

The “Slough of Despond” is one of Bunyan’s most famous images. Like that of any good allegorical figure, its rich complexity defies simple characterization, but among other things it is a swamp that traps people who are beginning their pilgrimage to the Heavenly City. The Slough itself stains and defiles, and in it the weight of sin is even more burdensome. It is ultimately revealed that the swamp is created from the discouragement that attends an awareness of personal sin. Although it is a trap or hazard on the path to salvation, it is one that cannot be completely mended, because the sorrow and fear created by an awareness of sin is natural (and even necessary) for those seeking to escape judgment.

Even if the Slough cannot ever be entirely drained, it should not be the great obstacle that it is. Here Bunyan is making a typical Puritan complaint against both the Catholic Church and the Anglican Church. Like a monarch ordering his highways to be maintained, God had commanded the road through the Slough to be repaired and provided much teaching to help Christians avoid being caught in the swamp of discouragement and self-doubt, yet these lessons had been mishandled, leaving many stuck in the mire. With appropriate instruction, a believer should be able to find God’s firm path through the dangerous slough. This is the fault of the state church, which neglects its essential functions and fails to teach important truths to its adherents, leaving pilgrims to find their own way down the difficult road to salvation.

Despite the hardships, Christian fights his way through the swamp, with the aid of the character Help—yet another reminder of the corporate aspect of Puritan faith. Christian needs others to give him a hand up from the swamp and to point him to the right path. and continues on his way. But Pliable, who before was so eager to experience the joys of the Heavenly City, is overwhelmed by the challenges of the journey and turns away. Christian continues on his way. The character Help is yet another reminder of the corporate aspect of Puritan faith. Christian needs others to give him a hand up from the swamp and to point him on the right way.

===Now I Saw in My Dream That by This Time Pliable Was Got Home===

Bunyan’s audience would have been very familiar with individuals who had temporarily associated themselves with Dissenting congregations and then returned to the state church. The story of Pliable served as a cautionary tale. Those who went back to their old ways were likely to get just as much grief from their neighbors as if they had remained true, yet they would also miss out on heaven. In fact, since Pliable is around to be derided by his neighbors while Christian has moved on, Pliable may be even be worse off in the present life, just as he will certainly be worse off in the future one.

===Now As Christian Was Walking Solitary===

Christian continues on his journey and encounters a new figure, a man who hasd advice for him. The pilgrim has set out on the road to the Heavenly City in order to have the burden lifted from his back. Mr. Worldly Wiseman suggests that there are easier ways to remove the burden, ways that do not involve hardship, danger, or the loss of his family and community standing.

From a Puritan perspective, images of morality and civility promoted by society and the Church of England were traps. As Puritans understood the Bible, human effort (“keeping the law”) was unable tocould not save people from God’s judgment. To them, much of what the state church offered was a reliance on human effort, helping people to feel better about themselves so that they no longer noticed their burden of sin but not actually providing salvation. The Puritans saw such teaching as a medicine that masked a patient’s symptoms without curing the deadly disease. In rejecting “morality,” the Puritans were not advocating wild, sinful lifestyles—after all, Puritanism today is a byword for ultrastrict conduct. Instead, they were rejecting “moralism,” the idea that avoiding certain conspicuous sins was enough to please God. Civility was an even greater trap, elevating politeness and deference to society’s ideals of appropriate public behavior as the ultimate standard of human conduct.

Mr. Worldly Wiseman mocks both the teaching of “the book” and Christian’s efforts to understand it. The warning not to meddle in things too high for him was typical of the advice that often uneducated Dissenters might frequently receive. Many educated people believed that only the trained experts of the state church were competent to interpret the Bible and God’s will and found it offensive that less-educated and less-qualified people would presume to do so. Although it was not necessarily true of the first generation of Puritans, there was an increasing element of class division between Dissenters and the supporters of the established church. This division would grow with time, so that most Nonconforming English groups (Congregationalists, Presbyterians, Baptists, and later Methodists), would be firmly working-class in orientation.

For Bunyan, socially acceptable alternatives to fleeing the City of Destruction were foolish tricks. The burden of sin was a real problem pointing to a real solution, and any alleged “cure” that caused a would-be pilgrim to forsake the journey to salvation was a terrible lie. Christian is taken in and leaves the correct road for a dead-end path. Even though the difficult way of salvation is full of misleading tracks, it is always possible to get back on the right road.

===So Christian Turned Out of His Way===[AuQ7]

The way of morality and civility seemed to offer an attractive short-cut to relief from the burden of sin, yet as Christian tries to go that direction, he finds the burden of sin growing and the path actually more difficultharder to follow. Trying to lead a genuinely moral life proves to be more difficult than it seemed initially, and is unable todoes not lead to salvation. Poor Christian despairs of ever reaching the Heavenly City. However, even though his sins are great, it is possible for him to return to the true path.

===Now Christian Looked for Nothing but Death===

Poor Christian despairs of ever reaching the Heavenly City. However, even though his sins are great, it is possible for him to return to the true path.

==Audience==

Bunyan wrote for the sorts of people who attended or were likely to attend congregations not affiliated with the Church of England. Such Dissenters might lack formal education but often knew the Bible well and were familiar, through sermons, with many of the types of imagery Bunyan employed in ''Pilgrim’s Progress''. The book was aimed both at those considering conversion and Christians who needed encouragement to remain faithful.

For many years ''Pilgrim’s Progress'' was appreciated as a classic work of English literature. Most English-language readers encounter it today only in the classroom, but Bunyan’s work still reaches an audience through other authors who have incorporated his values and ideas. Today ''Pilgrim’s Progress'' remains widely read as a religious work, particularly by Protestants of almost all denominations. Modern Christians particularly appreciate Bunyan’s theological understanding of discouragement as a natural part of faith. The text is also still used by Christian missionaries as a way to introduce Protestant beliefs about conversion and salvation.

==Impact==

It is often said that, after the Bible, ''Pilgrim’s Progress'' iswas the most printed, published, and translated book in the world. (It appeared in ninety different editions in the first hundred years after its publication and has been translated into more than two hundred languages.) Certainly it was the top best-seller in premodern England and enjoyed a similar popularity in colonial America. For generations Bunyan’s allegory was the most popular religious text in the English-speaking world.

Although Bunyan’s literary reputation has somewhat diminished in modern times, it was not only his religious views that were influential. Readers who passed over the spiritual message of ''Pilgrim’s Progress'' were often affected by Bunyan’s powerful and creative literary style. Bunyan’s influence extends even over those who reject his basic values or have never read his work—the popular magazine ''Vanity Fair'' takes its name from a large community’s market in ''Pilgrim’s Progress'', for Bunyan a place of temptation to avoid. Another of many of Bunyan’s phrases to enter popular culture is “Slough of Despond.”

As an author, Bunyan still continues to exert influence. C. S. Lewis, the author of the Narnia stories and a popular Christian writer, was inspired by Bunyan to write a modern Christian allegory, which he entitled ''The Pilgrim’s Regress''. ''Pilgrim’s Progress'' had a discernable impact on such classic literature as Charlotte Brontë’s ''Jane Eyre'', Louisa May Alcott’s ''Little Women'', and Kurt Vonnegut’s ''Slaughterhouse-Five'', and, of course, William Makepiece Makepeace Thackeray’s ''Vanity Fair'', as well as dozens of lesser-known modern works. It was made into an opera by Ralph Vaughan Williams and more recently into a rock opera.

More important to Bunyan would have been the religious legacy of his writing. When Bunyan wrote his classic work, he was expressing the values of a persecuted minority. With time, however, and certainly helped by the wide popularity of ''Pilgrim’s Progress'', Puritan beliefs became more and more mainstream, until today many of their convictions are widely held in the Protestant community worldwide. Bunyan’s understanding of conversion, of Christian mistrust of society, of the role of the individual, and of the authority of scripture are shared by the majority of Christians in Britain and the United States today. Perhaps the greatest testimony to how widely accepted ''Pilgrim’s Progress'' is by modern Christians is the inclusion of Christian’s hymn “He Who Would Valiant Be” in the Church of England hymnal.

==Essential Quotes==

“He answered, ‘Sir, I perceive, by the book in my hand, that I am condemned to die, and after that to come to judgment; and I find that I am not willing to do the first, nor able to do the second’” (chapter 1, paragraph 4).

“So I saw in my dream that the man began to run. Now he had not run far from his own door when his wife and children, perceiving it, began to cry after him to return; but the man put his fingers in his ears, and ran on crying, Life! life! eternal life!”(chapter 1, paragraph 8).

“So Christian turned out of his way to go to Mr. Legality’s house for help: but, behold, when he was got now hard by the hill, it seemed so high, and also that side of it that was next the way-side did hang so much over, that Christian was afraid to venture further, lest the hill should fall on his head; wherefore there he stood still, and wotted not what to do. Also his burden now seemed heavier to him than while he was in his way” (chapter 1, paragraph 80).

=Further Reading=

===Articles===

#Dutton, Richard A. “‘Interesting, but Tough’: Reading The Pilgrim’s Progress”. ''Studies in English Literature''18, no. 3 (Summer 1978): 439–456.

===Books===

#Bunyan, John. ''Grace Abounding to the Chief of Sinners''. New York: Penguin, 1987.
#Furlong, Monica. ''Puritan’s Progress: A Study of John Bunyan''. London: Hodder & Stoughton, 1975.
#Greaves, Richard L. ''Glimpses of Glory: John Bunyan and English Dissent''. Standford, Calif.: Stanford University Press, 2002.
#Hill, Christopher. ''A Tinker and a Poor Man: John Bunyan and His Church, 1628–1688''. New York: Knopf, 1988.
#Mullett, Michael. ''John Bunyan in Context''. Keele, U.K.: Keele University Press, 1996.
#Vincent Newey, ed. ''The Pilgrim’s Progress: Critical and Historical Views''. Liverpool, U.K.: University of Liverpool Press, 1980.
#Winslow, Ola Elizabeth. ''John Bunyan''. New York: Macmillan, 1961.  

—Raymond Powell

Main Page

2010-05-11T08:51:18Z

Cvr: /* Support at River Valley */

==Support at River Valley==

This is the main support page of [http://www.river-valley.com River Valley Technologies]. Currently we have started adding support documentation for the following:

*[[Elsarticle.cls|Author support for <code>elsarticle.cls</code>]]
*[[FAQ - elsarticle.cls|FAQ - <code>elsarticle.cls</code>]]
*[[Model-wise bibliographic style files]]
*[[adnd.sty|Author support for <code>adnd.sty</code>, auxiliary package for Journal of Atomic and Nuclear Data Tables]] [Not completed yet, but will hopefully be finished before long.]
* [[PDF annotators|Open Source tools to annotate PDFs]]
* [[Notes on TeX Live setup]]
* [[Notes on MacBook Pro Unibody]]
* [[Generating PDF/A compliant PDFs from pdftex]]
* [[Using TrueType fonts with pdfTeX]]
* [[epubgen: Creating epub files from Elsevier dataset]]
* [[Marcia|Guest Page]]

Epubgen: Creating epub files from Elsevier dataset

2009-10-21T09:59:47Z

Cvr: /* How to contact */

=='''What is epubgen?'''==
epubgen is a tool for generating [http://en.wikipedia.org/wiki/EPUB ePub] files from Elsevier's Journal and Book (Stand-alone and Book-Series) CONTRAST-out datasets. epubgen is created as a [http://en.wikipedia.org/wiki/Command-line_interface command line interface (CLI)] tool. This tool is compatible with both Linux and Windows platforms. The input is Elsevier's CONTRAST-OUT dataset and the output is the epub file. A dataset is actually an archive (in other terms a container of files). This archive may contain, the PDF, XML, stripins (gif images of MathML code), figures and a <code>dataset.xml</code>. <code>dataset.xml</code> is the entry point to the dataset which contains the details including path names of the files in the dataset.

This program is released under the GNU General Public License.

===Features===
# A single dataset may contain a collection of issues or books. By default each issue/book will be separate <code>ePub</code> file. But if <code>epub</code> files of each item (ie, article/book) is needed, then you can split the files.
# In the XML file, both MathML code and as an alternative, stripins (images of MathML code) are available. This program is now set in such a way that you can select to render MathML or view the images or SVG or all of them.
# You can select the level of the table of contents using the command line switch. Default is 3.
# This tool will work both in Linux and Windows Platforms.

===Software dependencies===
# <code>epubcheck</code> (version 1.0.4 or higher) which is a parser for epub files.
# <code>Perl 5.8.8</code> or higher
# <code>xsltproc</code>
# <code>saxon</code> (ver. 9 or higher)
# <code>xmllint</code>
# <code>convert</code> (ImageMagick 6.3.7 or higher)
# <code>zip</code>. The ePub file is actually a <code>zip</code> file with extension <code>.epub</code>.
# <code>Java 1.6</code> or higher.
# <code>Cygwin</code> is required for Windows.

===Installation===
The installation is so simple that you just need to unzip the archive. All the files will be extracted to a folder named epubgen-*.* which will be called `installation path' from now onwards. <code>*.*</code> stands for the correct version number which you see in the folder you get when you unzip the archive. This folder contains <code>epubgen.pl</code>, <code>epubgen.sh</code>, <code>epubgen.bat</code>, <code>epubgen.conf</code> etc. If you add the installation path to the system variable <code>PATH</code>, that will be the more efficient way of working.

Firstly, edit the <code>epub.conf</code> file to set the path of <code>Java</code>. Even if Java path is set properly in your system variables, setting this path in <code>epub.conf</code> is also necessary. For both Linux and Windows, seperate variables are given. If you are a Linux user, then set the variable for Linux and comment out the variable for Windows and vice versa.

==How to create epub files?==
Unzip the CONTRAST-OUT dataset to any folder and use the following syntax:

;Linux:

Syntax
epubgen.sh -d [Options] [name of folder where dataset.xml resides] \
-p [folder where epub file should be generated]

Example

epubgen.sh -d /opt/my-dataset/EWX00001158/ -p /opt/my-epub-files/

;Windows:
There is difference in the usage of commands for Cygwin terminal and default command line terminal. In the following syntax, the first one is for Cygwin terminal and the other is for default command line terminal:

Syntax
epubgen.sh -d [Options] [name of folder where dataset.xml resides]
-p [folder where epub file should be generated]
epubgen.pl -d [Options] [name of folder where dataset.xml resides]
-p [folder where epub file should be generated]

Example
epubgen.sh -d e:/my-dataset/EWX00001158/ -p e:/my-epub-files/
epubgen.pl -d e:\my-dataset\EWX00001158 -p e:\my-epub-files\

===List of options===
--valid or -v Validate the epub file produced. Default is to validate

--path or -p Path to which epub files are to be copied

--nostripins or -S Not to include stripins. Default is to include stripins

--svg or -g [yes|no] Whether to insert SVG code for math

--mathml or -m [yes|no] Whether to retain mathml code.
Default is no. Either stripins or mathml is required however

--item or -i To split epub files item wise. Default is single epub for single issue

--level or -l Level of table of contents to be included in the toc.ncx file of epub. Default is 3

==Project home page==
This project is hosted in gna.org. The URL is:

[https://gna.org/projects/epubgen https://gna.org/projects/epubgen]

To get the information about how to access the source code repository, please visit the following URL:

[https://gna.org/svn/?group=epubgen https://gna.org/svn/?group=epubgen]

==How to contact==
Suggestions, recommendations, feature requests, bug reports, etc can be send to [mailto:latex.support@river-valley.com Support]. Bugs can also be filed at the [https://gna.org/bugs/?func=additem&group=epubgen Bugtracker], but you need to login at [http://gna.org http://gna.org].

Epubgen: Creating epub files from Elsevier dataset

2009-10-21T09:58:53Z

Cvr: /* Project home page */

=='''What is epubgen?'''==
epubgen is a tool for generating [http://en.wikipedia.org/wiki/EPUB ePub] files from Elsevier's Journal and Book (Stand-alone and Book-Series) CONTRAST-out datasets. epubgen is created as a [http://en.wikipedia.org/wiki/Command-line_interface command line interface (CLI)] tool. This tool is compatible with both Linux and Windows platforms. The input is Elsevier's CONTRAST-OUT dataset and the output is the epub file. A dataset is actually an archive (in other terms a container of files). This archive may contain, the PDF, XML, stripins (gif images of MathML code), figures and a <code>dataset.xml</code>. <code>dataset.xml</code> is the entry point to the dataset which contains the details including path names of the files in the dataset.

This program is released under the GNU General Public License.

===Features===
# A single dataset may contain a collection of issues or books. By default each issue/book will be separate <code>ePub</code> file. But if <code>epub</code> files of each item (ie, article/book) is needed, then you can split the files.
# In the XML file, both MathML code and as an alternative, stripins (images of MathML code) are available. This program is now set in such a way that you can select to render MathML or view the images or SVG or all of them.
# You can select the level of the table of contents using the command line switch. Default is 3.
# This tool will work both in Linux and Windows Platforms.

===Software dependencies===
# <code>epubcheck</code> (version 1.0.4 or higher) which is a parser for epub files.
# <code>Perl 5.8.8</code> or higher
# <code>xsltproc</code>
# <code>saxon</code> (ver. 9 or higher)
# <code>xmllint</code>
# <code>convert</code> (ImageMagick 6.3.7 or higher)
# <code>zip</code>. The ePub file is actually a <code>zip</code> file with extension <code>.epub</code>.
# <code>Java 1.6</code> or higher.
# <code>Cygwin</code> is required for Windows.

===Installation===
The installation is so simple that you just need to unzip the archive. All the files will be extracted to a folder named epubgen-*.* which will be called `installation path' from now onwards. <code>*.*</code> stands for the correct version number which you see in the folder you get when you unzip the archive. This folder contains <code>epubgen.pl</code>, <code>epubgen.sh</code>, <code>epubgen.bat</code>, <code>epubgen.conf</code> etc. If you add the installation path to the system variable <code>PATH</code>, that will be the more efficient way of working.

Firstly, edit the <code>epub.conf</code> file to set the path of <code>Java</code>. Even if Java path is set properly in your system variables, setting this path in <code>epub.conf</code> is also necessary. For both Linux and Windows, seperate variables are given. If you are a Linux user, then set the variable for Linux and comment out the variable for Windows and vice versa.

==How to create epub files?==
Unzip the CONTRAST-OUT dataset to any folder and use the following syntax:

;Linux:

Syntax
epubgen.sh -d [Options] [name of folder where dataset.xml resides] \
-p [folder where epub file should be generated]

Example

epubgen.sh -d /opt/my-dataset/EWX00001158/ -p /opt/my-epub-files/

;Windows:
There is difference in the usage of commands for Cygwin terminal and default command line terminal. In the following syntax, the first one is for Cygwin terminal and the other is for default command line terminal:

Syntax
epubgen.sh -d [Options] [name of folder where dataset.xml resides]
-p [folder where epub file should be generated]
epubgen.pl -d [Options] [name of folder where dataset.xml resides]
-p [folder where epub file should be generated]

Example
epubgen.sh -d e:/my-dataset/EWX00001158/ -p e:/my-epub-files/
epubgen.pl -d e:\my-dataset\EWX00001158 -p e:\my-epub-files\

===List of options===
--valid or -v Validate the epub file produced. Default is to validate

--path or -p Path to which epub files are to be copied

--nostripins or -S Not to include stripins. Default is to include stripins

--svg or -g [yes|no] Whether to insert SVG code for math

--mathml or -m [yes|no] Whether to retain mathml code.
Default is no. Either stripins or mathml is required however

--item or -i To split epub files item wise. Default is single epub for single issue

--level or -l Level of table of contents to be included in the toc.ncx file of epub. Default is 3

==Project home page==
This project is hosted in gna.org. The URL is:

[https://gna.org/projects/epubgen https://gna.org/projects/epubgen]

To get the information about how to access the source code repository, please visit the following URL:

[https://gna.org/svn/?group=epubgen https://gna.org/svn/?group=epubgen]

==How to contact==
suggestions, recommendations, bug reports, etc can be send to [mailto:latex.support@river-valley.com Support]. Bugs can also be filed at the [https://gna.org/bugs/?func=additem&group=epubgen Bugtracker], but you need to login at [http://gna.org http://gna.org].

Epubgen: Creating epub files from Elsevier dataset

2009-10-21T09:49:37Z

Cvr: /* How to create epub files? */

=='''What is epubgen?'''==
epubgen is a tool for generating [http://en.wikipedia.org/wiki/EPUB ePub] files from Elsevier's Journal and Book (Stand-alone and Book-Series) CONTRAST-out datasets. epubgen is created as a [http://en.wikipedia.org/wiki/Command-line_interface command line interface (CLI)] tool. This tool is compatible with both Linux and Windows platforms. The input is Elsevier's CONTRAST-OUT dataset and the output is the epub file. A dataset is actually an archive (in other terms a container of files). This archive may contain, the PDF, XML, stripins (gif images of MathML code), figures and a <code>dataset.xml</code>. <code>dataset.xml</code> is the entry point to the dataset which contains the details including path names of the files in the dataset.

This program is released under the GNU General Public License.

===Features===
# A single dataset may contain a collection of issues or books. By default each issue/book will be separate <code>ePub</code> file. But if <code>epub</code> files of each item (ie, article/book) is needed, then you can split the files.
# In the XML file, both MathML code and as an alternative, stripins (images of MathML code) are available. This program is now set in such a way that you can select to render MathML or view the images or SVG or all of them.
# You can select the level of the table of contents using the command line switch. Default is 3.
# This tool will work both in Linux and Windows Platforms.

===Software dependencies===
# <code>epubcheck</code> (version 1.0.4 or higher) which is a parser for epub files.
# <code>Perl 5.8.8</code> or higher
# <code>xsltproc</code>
# <code>saxon</code> (ver. 9 or higher)
# <code>xmllint</code>
# <code>convert</code> (ImageMagick 6.3.7 or higher)
# <code>zip</code>. The ePub file is actually a <code>zip</code> file with extension <code>.epub</code>.
# <code>Java 1.6</code> or higher.
# <code>Cygwin</code> is required for Windows.

===Installation===
The installation is so simple that you just need to unzip the archive. All the files will be extracted to a folder named epubgen-*.* which will be called `installation path' from now onwards. <code>*.*</code> stands for the correct version number which you see in the folder you get when you unzip the archive. This folder contains <code>epubgen.pl</code>, <code>epubgen.sh</code>, <code>epubgen.bat</code>, <code>epubgen.conf</code> etc. If you add the installation path to the system variable <code>PATH</code>, that will be the more efficient way of working.

Firstly, edit the <code>epub.conf</code> file to set the path of <code>Java</code>. Even if Java path is set properly in your system variables, setting this path in <code>epub.conf</code> is also necessary. For both Linux and Windows, seperate variables are given. If you are a Linux user, then set the variable for Linux and comment out the variable for Windows and vice versa.

==How to create epub files?==
Unzip the CONTRAST-OUT dataset to any folder and use the following syntax:

;Linux:

Syntax
epubgen.sh -d [Options] [name of folder where dataset.xml resides] \
-p [folder where epub file should be generated]

Example

epubgen.sh -d /opt/my-dataset/EWX00001158/ -p /opt/my-epub-files/

;Windows:
There is difference in the usage of commands for Cygwin terminal and default command line terminal. In the following syntax, the first one is for Cygwin terminal and the other is for default command line terminal:

Syntax
epubgen.sh -d [Options] [name of folder where dataset.xml resides]
-p [folder where epub file should be generated]
epubgen.pl -d [Options] [name of folder where dataset.xml resides]
-p [folder where epub file should be generated]

Example
epubgen.sh -d e:/my-dataset/EWX00001158/ -p e:/my-epub-files/
epubgen.pl -d e:\my-dataset\EWX00001158 -p e:\my-epub-files\

===List of options===
--valid or -v Validate the epub file produced. Default is to validate

--path or -p Path to which epub files are to be copied

--nostripins or -S Not to include stripins. Default is to include stripins

--svg or -g [yes|no] Whether to insert SVG code for math

--mathml or -m [yes|no] Whether to retain mathml code.
Default is no. Either stripins or mathml is required however

--item or -i To split epub files item wise. Default is single epub for single issue

--level or -l Level of table of contents to be included in the toc.ncx file of epub. Default is 3

===Project home page===
This project is hosted in gna.org. The URL is:

[https://gna.org/projects/epubgen https://gna.org/projects/epubgen]

To get the information about how to access the source code repository, please visit the following URL:

[https://gna.org/svn/?group=epubgen https://gna.org/svn/?group=epubgen]

Epubgen: Creating epub files from Elsevier dataset

2009-10-21T09:48:05Z

Cvr: /* How to create epub files? */

=='''What is epubgen?'''==
epubgen is a tool for generating [http://en.wikipedia.org/wiki/EPUB ePub] files from Elsevier's Journal and Book (Stand-alone and Book-Series) CONTRAST-out datasets. epubgen is created as a [http://en.wikipedia.org/wiki/Command-line_interface command line interface (CLI)] tool. This tool is compatible with both Linux and Windows platforms. The input is Elsevier's CONTRAST-OUT dataset and the output is the epub file. A dataset is actually an archive (in other terms a container of files). This archive may contain, the PDF, XML, stripins (gif images of MathML code), figures and a <code>dataset.xml</code>. <code>dataset.xml</code> is the entry point to the dataset which contains the details including path names of the files in the dataset.

This program is released under the GNU General Public License.

===Features===
# A single dataset may contain a collection of issues or books. By default each issue/book will be separate <code>ePub</code> file. But if <code>epub</code> files of each item (ie, article/book) is needed, then you can split the files.
# In the XML file, both MathML code and as an alternative, stripins (images of MathML code) are available. This program is now set in such a way that you can select to render MathML or view the images or SVG or all of them.
# You can select the level of the table of contents using the command line switch. Default is 3.
# This tool will work both in Linux and Windows Platforms.

===Software dependencies===
# <code>epubcheck</code> (version 1.0.4 or higher) which is a parser for epub files.
# <code>Perl 5.8.8</code> or higher
# <code>xsltproc</code>
# <code>saxon</code> (ver. 9 or higher)
# <code>xmllint</code>
# <code>convert</code> (ImageMagick 6.3.7 or higher)
# <code>zip</code>. The ePub file is actually a <code>zip</code> file with extension <code>.epub</code>.
# <code>Java 1.6</code> or higher.
# <code>Cygwin</code> is required for Windows.

===Installation===
The installation is so simple that you just need to unzip the archive. All the files will be extracted to a folder named epubgen-*.* which will be called `installation path' from now onwards. <code>*.*</code> stands for the correct version number which you see in the folder you get when you unzip the archive. This folder contains <code>epubgen.pl</code>, <code>epubgen.sh</code>, <code>epubgen.bat</code>, <code>epubgen.conf</code> etc. If you add the installation path to the system variable <code>PATH</code>, that will be the more efficient way of working.

Firstly, edit the <code>epub.conf</code> file to set the path of <code>Java</code>. Even if Java path is set properly in your system variables, setting this path in <code>epub.conf</code> is also necessary. For both Linux and Windows, seperate variables are given. If you are a Linux user, then set the variable for Linux and comment out the variable for Windows and vice versa.

===How to create epub files?===
Unzip the CONTRAST-OUT dataset to any folder and use the following syntax:

;Linux:

Syntax
epubgen.sh -d [Options] [name of folder where dataset.xml resides] \
-p [folder where epub file should be generated]

Example

epubgen.sh -d /opt/my-dataset/EWX00001158/ -p /opt/my-epub-files/

;Windows:
There is difference in the usage of commands for Cygwin terminal and default command line terminal. In the following syntax, the first one is for Cygwin terminal and the other is for default command line terminal:

Syntax
epubgen.sh -d [Options] [name of folder where dataset.xml resides]
-p [folder where epub file should be generated]
epubgen.pl -d [Options] [name of folder where dataset.xml resides]
-p [folder where epub file should be generated]

Example
epubgen.sh -d e:/my-dataset/EWX00001158/ -p e:/my-epub-files/
epubgen.pl -d e:\my-dataset\EWX00001158 -p e:\my-epub-files\

====List of options====
--valid or -v Validate the epub file produced. Default is to validate

--path or -p Path to which epub files are to be copied

--nostripins or -S Not to include stripins. Default is to include stripins

--svg or -g [yes|no] Whether to insert SVG code for math

--mathml or -m [yes|no] Whether to retain mathml code.
Default is no. Either stripins or mathml is required however

--item or -i To split epub files item wise. Default is single epub for single issue

--level or -l Level of table of contents to be included in the toc.ncx file of epub. Default is 3

===Project home page===
This project is hosted in gna.org. The URL is:

[https://gna.org/projects/epubgen https://gna.org/projects/epubgen]

To get the information about how to access the source code repository, please visit the following URL:

[https://gna.org/svn/?group=epubgen https://gna.org/svn/?group=epubgen]

Epubgen: Creating epub files from Elsevier dataset

2009-10-21T09:45:35Z

Cvr: /* Software dependencies */

=='''What is epubgen?'''==
epubgen is a tool for generating [http://en.wikipedia.org/wiki/EPUB ePub] files from Elsevier's Journal and Book (Stand-alone and Book-Series) CONTRAST-out datasets. epubgen is created as a [http://en.wikipedia.org/wiki/Command-line_interface command line interface (CLI)] tool. This tool is compatible with both Linux and Windows platforms. The input is Elsevier's CONTRAST-OUT dataset and the output is the epub file. A dataset is actually an archive (in other terms a container of files). This archive may contain, the PDF, XML, stripins (gif images of MathML code), figures and a <code>dataset.xml</code>. <code>dataset.xml</code> is the entry point to the dataset which contains the details including path names of the files in the dataset.

This program is released under the GNU General Public License.

===Features===
# A single dataset may contain a collection of issues or books. By default each issue/book will be separate <code>ePub</code> file. But if <code>epub</code> files of each item (ie, article/book) is needed, then you can split the files.
# In the XML file, both MathML code and as an alternative, stripins (images of MathML code) are available. This program is now set in such a way that you can select to render MathML or view the images or SVG or all of them.
# You can select the level of the table of contents using the command line switch. Default is 3.
# This tool will work both in Linux and Windows Platforms.

===Software dependencies===
# <code>epubcheck</code> (version 1.0.4 or higher) which is a parser for epub files.
# <code>Perl 5.8.8</code> or higher
# <code>xsltproc</code>
# <code>saxon</code> (ver. 9 or higher)
# <code>xmllint</code>
# <code>convert</code> (ImageMagick 6.3.7 or higher)
# <code>zip</code>. The ePub file is actually a <code>zip</code> file with extension <code>.epub</code>.
# <code>Java 1.6</code> or higher.
# <code>Cygwin</code> is required for Windows.

===Installation===
The installation is so simple that you just need to unzip the archive. All the files will be extracted to a folder named epubgen-*.* which will be called `installation path' from now onwards. <code>*.*</code> stands for the correct version number which you see in the folder you get when you unzip the archive. This folder contains <code>epubgen.pl</code>, <code>epubgen.sh</code>, <code>epubgen.bat</code>, <code>epubgen.conf</code> etc. If you add the installation path to the system variable <code>PATH</code>, that will be the more efficient way of working.

Firstly, edit the <code>epub.conf</code> file to set the path of <code>Java</code>. Even if Java path is set properly in your system variables, setting this path in <code>epub.conf</code> is also necessary. For both Linux and Windows, seperate variables are given. If you are a Linux user, then set the variable for Linux and comment out the variable for Windows and vice versa.

===How to create epub files?===
Unzip the CONTRAST-OUT dataset to any folder and use the following syntax:

;Linux:

Syntax
epubgen.sh -d [Options] [name of folder where dataset.xml resides] -p [folder where epub file should be generated]

Example

epubgen.sh -d /opt/my-dataset/EWX00001158/ -p /opt/my-epub-files/

;Windows:
There is difference in the usage of commands for Cygwin terminal and default command line terminal. In the following syntax, the first one is for Cygwin terminal and the other is for default command line terminal:

Syntax
epubgen.sh -d [Options] [name of folder where dataset.xml resides] -p [folder where epub file should be generated]
epubgen.pl -d [Options] [name of folder where dataset.xml resides] -p [folder where epub file should be generated]

Example
epubgen.sh -d e:/my-dataset/EWX00001158/ -p e:/my-epub-files/
epubgen.pl -d e:\my-dataset\EWX00001158 -p e:\my-epub-files\

====List of options====
--valid or -v Validate the epub file produced. Default is to validate

--path or -p Path to which epub files are to be copied

--nostripins or -S Not to include stripins. Default is to include stripins

--svg or -g [yes|no] Whether to insert SVG code for math

--mathml or -m [yes|no] Whether to retain mathml code.
Default is no. Either stripins or mathml is required however

--item or -i To split epub files item wise. Default is single epub for single issue

--level or -l Level of table of contents to be included in the toc.ncx file of epub. Default is 3

===Project home page===
This project is hosted in gna.org. The URL is:

[https://gna.org/projects/epubgen https://gna.org/projects/epubgen]

To get the information about how to access the source code repository, please visit the following URL:

[https://gna.org/svn/?group=epubgen https://gna.org/svn/?group=epubgen]

Epubgen: Creating epub files from Elsevier dataset

2009-10-21T09:43:51Z

Cvr: /* Features */

=='''What is epubgen?'''==
epubgen is a tool for generating [http://en.wikipedia.org/wiki/EPUB ePub] files from Elsevier's Journal and Book (Stand-alone and Book-Series) CONTRAST-out datasets. epubgen is created as a [http://en.wikipedia.org/wiki/Command-line_interface command line interface (CLI)] tool. This tool is compatible with both Linux and Windows platforms. The input is Elsevier's CONTRAST-OUT dataset and the output is the epub file. A dataset is actually an archive (in other terms a container of files). This archive may contain, the PDF, XML, stripins (gif images of MathML code), figures and a <code>dataset.xml</code>. <code>dataset.xml</code> is the entry point to the dataset which contains the details including path names of the files in the dataset.

This program is released under the GNU General Public License.

===Features===
# A single dataset may contain a collection of issues or books. By default each issue/book will be separate <code>ePub</code> file. But if <code>epub</code> files of each item (ie, article/book) is needed, then you can split the files.
# In the XML file, both MathML code and as an alternative, stripins (images of MathML code) are available. This program is now set in such a way that you can select to render MathML or view the images or SVG or all of them.
# You can select the level of the table of contents using the command line switch. Default is 3.
# This tool will work both in Linux and Windows Platforms.

===Software dependencies===
# epubcheck (version 1.0.4 or higher) which is a parser for epub files.
# Perl 5.8.8 or higher
# xsltproc
# saxon (ver. 9 or higher)
# xmllint
# convert (ImageMagick 6.3.7 or higher)
# zip. The ePub file is actually a zip file with extension <code>.epub</code>.
# Java 1.6 or higher.
# Cygwin is required for Windows.

===Installation===
The installation is so simple that you just need to unzip the archive. All the files will be extracted to a folder named epubgen-*.* which will be called `installation path' from now onwards. <code>*.*</code> stands for the correct version number which you see in the folder you get when you unzip the archive. This folder contains <code>epubgen.pl</code>, <code>epubgen.sh</code>, <code>epubgen.bat</code>, <code>epubgen.conf</code> etc. If you add the installation path to the system variable <code>PATH</code>, that will be the more efficient way of working.

Firstly, edit the <code>epub.conf</code> file to set the path of <code>Java</code>. Even if Java path is set properly in your system variables, setting this path in <code>epub.conf</code> is also necessary. For both Linux and Windows, seperate variables are given. If you are a Linux user, then set the variable for Linux and comment out the variable for Windows and vice versa.

===How to create epub files?===
Unzip the CONTRAST-OUT dataset to any folder and use the following syntax:

;Linux:

Syntax
epubgen.sh -d [Options] [name of folder where dataset.xml resides] -p [folder where epub file should be generated]

Example

epubgen.sh -d /opt/my-dataset/EWX00001158/ -p /opt/my-epub-files/

;Windows:
There is difference in the usage of commands for Cygwin terminal and default command line terminal. In the following syntax, the first one is for Cygwin terminal and the other is for default command line terminal:

Syntax
epubgen.sh -d [Options] [name of folder where dataset.xml resides] -p [folder where epub file should be generated]
epubgen.pl -d [Options] [name of folder where dataset.xml resides] -p [folder where epub file should be generated]

Example
epubgen.sh -d e:/my-dataset/EWX00001158/ -p e:/my-epub-files/
epubgen.pl -d e:\my-dataset\EWX00001158 -p e:\my-epub-files\

====List of options====
--valid or -v Validate the epub file produced. Default is to validate

--path or -p Path to which epub files are to be copied

--nostripins or -S Not to include stripins. Default is to include stripins

--svg or -g [yes|no] Whether to insert SVG code for math

--mathml or -m [yes|no] Whether to retain mathml code.
Default is no. Either stripins or mathml is required however

--item or -i To split epub files item wise. Default is single epub for single issue

--level or -l Level of table of contents to be included in the toc.ncx file of epub. Default is 3

===Project home page===
This project is hosted in gna.org. The URL is:

[https://gna.org/projects/epubgen https://gna.org/projects/epubgen]

To get the information about how to access the source code repository, please visit the following URL:

[https://gna.org/svn/?group=epubgen https://gna.org/svn/?group=epubgen]

Epubgen: Creating epub files from Elsevier dataset

2009-10-21T09:41:17Z

Cvr: /* What is epubgen? */

=='''What is epubgen?'''==
epubgen is a tool for generating [http://en.wikipedia.org/wiki/EPUB ePub] files from Elsevier's Journal and Book (Stand-alone and Book-Series) CONTRAST-out datasets. epubgen is created as a [http://en.wikipedia.org/wiki/Command-line_interface command line interface (CLI)] tool. This tool is compatible with both Linux and Windows platforms. The input is Elsevier's CONTRAST-OUT dataset and the output is the epub file. A dataset is actually an archive (in other terms a container of files). This archive may contain, the PDF, XML, stripins (gif images of MathML code), figures and a <code>dataset.xml</code>. <code>dataset.xml</code> is the entry point to the dataset which contains the details including path names of the files in the dataset.

This program is released under the GNU General Public License.

===Features===
# A single dataset may contain a collection of issues or books. By default each issues/books will be seperate ePub file. But if epub files of each item (ie, article/book) is needed, then you can split the files.
# In the XML file, both MathML code and as an alternative, stripins (images of MathML code) are available. This program is now set in such a way that you can select to render MathML or view the images or SVG or all of them.
# You can select the level of the table of contents using the command line switch. Default is 3.
# This tool will work both in Linux and Windows Platform.

===Software dependencies===
# epubcheck (version 1.0.4 or higher) which is a parser for epub files.
# Perl 5.8.8 or higher
# xsltproc
# saxon (ver. 9 or higher)
# xmllint
# convert (ImageMagick 6.3.7 or higher)
# zip. The ePub file is actually a zip file with extension <code>.epub</code>.
# Java 1.6 or higher.
# Cygwin is required for Windows.

===Installation===
The installation is so simple that you just need to unzip the archive. All the files will be extracted to a folder named epubgen-*.* which will be called `installation path' from now onwards. <code>*.*</code> stands for the correct version number which you see in the folder you get when you unzip the archive. This folder contains <code>epubgen.pl</code>, <code>epubgen.sh</code>, <code>epubgen.bat</code>, <code>epubgen.conf</code> etc. If you add the installation path to the system variable <code>PATH</code>, that will be the more efficient way of working.

Firstly, edit the <code>epub.conf</code> file to set the path of <code>Java</code>. Even if Java path is set properly in your system variables, setting this path in <code>epub.conf</code> is also necessary. For both Linux and Windows, seperate variables are given. If you are a Linux user, then set the variable for Linux and comment out the variable for Windows and vice versa.

===How to create epub files?===
Unzip the CONTRAST-OUT dataset to any folder and use the following syntax:

;Linux:

Syntax
epubgen.sh -d [Options] [name of folder where dataset.xml resides] -p [folder where epub file should be generated]

Example

epubgen.sh -d /opt/my-dataset/EWX00001158/ -p /opt/my-epub-files/

;Windows:
There is difference in the usage of commands for Cygwin terminal and default command line terminal. In the following syntax, the first one is for Cygwin terminal and the other is for default command line terminal:

Syntax
epubgen.sh -d [Options] [name of folder where dataset.xml resides] -p [folder where epub file should be generated]
epubgen.pl -d [Options] [name of folder where dataset.xml resides] -p [folder where epub file should be generated]

Example
epubgen.sh -d e:/my-dataset/EWX00001158/ -p e:/my-epub-files/
epubgen.pl -d e:\my-dataset\EWX00001158 -p e:\my-epub-files\

====List of options====
--valid or -v Validate the epub file produced. Default is to validate

--path or -p Path to which epub files are to be copied

--nostripins or -S Not to include stripins. Default is to include stripins

--svg or -g [yes|no] Whether to insert SVG code for math

--mathml or -m [yes|no] Whether to retain mathml code.
Default is no. Either stripins or mathml is required however

--item or -i To split epub files item wise. Default is single epub for single issue

--level or -l Level of table of contents to be included in the toc.ncx file of epub. Default is 3

===Project home page===
This project is hosted in gna.org. The URL is:

[https://gna.org/projects/epubgen https://gna.org/projects/epubgen]

To get the information about how to access the source code repository, please visit the following URL:

[https://gna.org/svn/?group=epubgen https://gna.org/svn/?group=epubgen]

Model-wise bibliographic style files

2009-10-20T11:36:18Z

Main Page

2009-06-30T06:26:56Z

Cvr: /* Support at River Valley */

==Support at River Valley==

This is the main support page of [http://www.river-valley.com River Valley Technologies]. Currently we have started adding support documentation for the following:

*[[Elsarticle.cls|Author support for <code>elsarticle.cls</code>]]
*[[FAQ - elsarticle.cls|FAQ - <code>elsarticle.cls</code>]]
*[[adnd.sty|Author support for <code>adnd.sty</code>, auxiliary package for Journal of Atomic and Nuclear Data Tables]]
Not completed yet, but will hopefully be finished before long.
* [[PDF annotators|Open Source tools to annotate PDFs]]
* [[Notes on TeX Live setup]]
* [[Notes on MacBook Pro Unibody]]
* [[Generating PDF/A compliant PDFs from pdftex]]
* [[Using TrueType fonts with pdfTeX]]

Elsarticle.cls

2009-06-17T08:32:54Z

Cvr: /* Cross-references */

==Introduction==

<code>elsarticle.cls</code> is a thoroughly rewritten document class
for formatting LaTeX submissions to Elsevier journals.
The class uses the environments and commands defined in LaTeX kernel
without change to the signature so that clashes with other
contributed LaTeX packages like <code>hyperref.sty</code>,
<code>preview-latex.sty</code>, etc., will be minimal.
<code>elsarticle.cls</code> is primarily built upon the default
<code>article.cls</code>. The class depends on the following packages
for its proper functionality:

# <code>pifont.sty</code> for openstar in the title footnotes.
# <code>natbib.sty</code> for citation processing.
# <code>geometry.sty</code> for margin settings.
# <code>fleqn.clo</code> for left aligned equations.
# <code>graphicx.sty</code> for graphics inclusion.
# <code>txfonts.sty</code> optional font package, if document is to be formatted with Times and compatible math fonts.
# <code>hyperref.sty</code> optional packages if hyper linking is required in the document.

All the above packages are part of any standard LaTeX installation.
Therefore, the users need not be bothered about downloading any
extra packages. Further, users are free to make use of AMS
math packages like, <code>amsmath.sty</code>, <code>amsthm.sty</code>,
<code>amssymb.sty</code>, <code>amsfonts.sty</code>, etc., if they want. All
these packages work in tandem with <code>elsarticle.cls</code> without
any problems.

==Major Differences==

Following are the major differences between <code>elsarticle.cls</code> and its predecesor package, <code>elsart.cls</code>:
* <code>elsarticle.cls</code> is built upon <code>article.cls</code> while <code>elsart.cls</code> is not. <code>elsart.cls</code> redefines many of the commands in the LaTeX classes/kernel, which can possibly cause surprising clashes with other contributed LaTeX packages.
* Provides preprint document formatting by default, and optionally formats the document as per the final style of models <code>1+</code>, <code>3+</code> and <code>5+</code> of Elsevier journals.
* Some easier hooks for formatting <code>list</code> and <code>theorem</code> environments are provided while people can still use <code>amsthm.sty</code> package.
* <code>natbib.sty</code> is the main citation processing package which can comprehensively handle all kinds of citations and works perfectly with <code>hyperref.sty</code> in combination with <code>hypernat.sty</code>.
* Long title pages are processed correctly in preprint and final formats.

==Installation==

The package is available at [http://www.elsevier.com/locate/latex author resources page at Elsevier Science].
It can also be found in any of the nodes of the Comprehensive TeX Archive Network (CTAN), one of the primary nodes being [http://www.ctan.org/tex-archive/macros/latex/contrib/elsevier/ http://www.ctan.org]. Please grab the <code>elsarticle.dtx</code> which is the composite class with documentation and <code>elsarticle.ins</code> which is the LaTeX installer file. When we compile the <code>elsarticle.ins</code> with LaTeX it provides the class file, <code>elsarticle.cls</code> by stripping off all the documentation from the <code>*.dtx</code> file. The class may be moved or copied to a place, usually, <code>$TEXMF/tex/latex/elsevier/</code>, or a folder which will be read by LaTeX during document compilation. The TeX file database needs updation after moving/copying class file. Usually, we use commands like <code>mktexlsr</code> or <code>texhash</code> depending upon the distribution and operating system.

==Usage==

The class should be loaded with the command:
<geshi lang="latex">
\documentclass[<options>]{elsarticle}
</geshi>
where the <code>options</code> can be the following:

; <code>preprint</code>: default options which formats the document for submission to Elsevier journals.
; <code>review</code>: similar to <code>preprint</code> option, but increases the baselineskip to facilitate easier review process.
; <code>1p</code>: formats to the look and feel of the final format of model 1+ journals. This is always single column style.
; <code>3p</code>: formats to the look and feel of the final format of model 3+ journals. If the journal is a two column model use <code>twocolumn</code> option in combination.
; <code>5p</code>: formats for model 5+ journals. This is always two column style.
; <code>authoryear</code>: author-year citation style of <code>natbib.sty</code>. If you want to add extra options of <code>natbib.sty</code>, you may use the options as a comma delimited strings as argument to <code>\biboptions</code> command. An example would be:
<geshi lang="latex">
\biboptions{longnamesfirst,angle,semicolon}
</geshi>
; <code>number</code>: numbered citation style. Extra options can be loaded with <code>\biboptions</code> command.
; <code>sort&compress</code>: sorts and compresses the numbered citations. Example, citation [1,2,3] will become [1-3].
; <code>longtitle</code>: if front matter is unusually long, use this option to split the title page across pages with correct placing of title and author footnotes in the first page.
; <code>times</code>: loads <code>txfonts.sty</code> if available in the system to use Times and compatible math fonts.
* All options of <code>article.cls</code> can be used with this document class.
* The default options loaded are <code>a4paper</code>, <code>10pt</code>, <code>oneside</code>, <code>onecolumn</code> and <code>preprint</code>.

==Front matter==

There are two types of front matter coding — (1) each author is connected to an affiliation with a footnote marker; hence all
authors are grouped together and affiliations follow; (2) authors
of same affiliations are grouped together and the relevant
affiliation follows this group. An example coding of the first
type is provided below:

<geshi lang="latex">
\begin{frontmatter}
\title{This is a specimen title\tnoteref{t1,t2}}
\tnotetext[t1]{This document is a collaborative effort.}
\tnotetext[t2]{The second title footnote which is a longer
longer than the first one and with an intention to fill
in up more than one line while formatting.}

\author[rvt]{C.V.~Radhakrishnan\corref{cor1}\fnref{fn1}}
\ead{cvr@river-valley.com}

\author[rvt,focal]{K.~Bazargan\fnref{fn2}}
\ead{kaveh@river-valley.com}

\author[els]{S.~Pepping\corref{cor2}\fnref{fn1,fn3}}
\ead[url]{http://www.elsevier.com}

\cortext[cor1]{Corresponding author}
\cortext[cor2]{Principal corresponding author}
\fntext[fn1]{This is the specimen author footnote.}
\fntext[fn2]{Another author footnote, but a little more longer.}
\fntext[fn3]{Yet another author footnote. Indeed, you can have
any number of author footnotes.}

\address[rvt]{River Valley Technologies, SJP Building,
Cotton Hills, Trivandrum, Kerala, India 695014}
\address[focal]{River Valley Technologies, 9, Browns Court,
Kennford, Exeter, United Kingdom}
\address[els]{Central Application Management,
Elsevier, Radarweg 29, 1043 NX\\
Amsterdam, Netherlands}
. . .
. . .
\end{frontmatter}
</geshi>

Output of the above TeX sources will look like the following:

<table border="1" cellspacing="3" cellpadding="3">
<tr><td>



[[Image:Els1.png]]



</td></tr></table>

Most of the commands like <code>\title</code>, <code>\author</code>, <code>\address</code> are self explanatory. Various components are linked each other by a
label–reference mechanism, for instance, title footnote is linked to the title with a footnote mark generated by referring to the <code>\label</code> string of the <code>\tnotetext</code>. We have used similar commands like <code>\tnoteref</code> (to link title note to title); <code>\corref</code> (to link corresponding author text to corresponding author); <code>\fnref</code> (to link footnote text to the relevant author names). TeX needs two compilations to resolve the footnote marks in the preamble part. Given below are the syntax of various note marks and note texts.
<geshi lang="latex">
\tnoteref{<label(s)>}
\corref{<label(s)>}
\fnref{<label(s)>}
\tnotetext[<label>]{<title note text>}
\cortext[<label>]{<corresponding author note text>}
\fntext[<label>]{<author footnote text>}
</geshi>
where <code><label(s)></code> can be either one or more comma delimited
label strings. The optional arguments to the <code>\author</code>
command holds the ref label(s) of the address(es) to which the author
is affiliated while each <code>\address</code> command can have an
optional argument of a label. In the same manner,
<code>\tnotetext</code>, <code>\fntext</code>, <code>\cortext</code>
will have optional arguments as their respective labels and note text
as their mandatory argument.

The following example code provides the markup of the second type of
author-affiliation.
<geshi lang="latex">
\author{C.V.~Radhakrishnan\corref{cor1}\fnref{fn1}}
\ead{cvr@river-valley.com}
\address{River Valley Technologies, SJP Building,
Cotton Hills, Trivandrum, Kerala, India 695014}
</geshi>
<geshi lang="latex">
\author{K.~Bazargan\fnref{fn2}}
\ead{kaveh@river-valley.com}
\address{River Valley Technologies, 9, Browns Court, Kennford,
Exeter, United Kingdom}
</geshi>
<geshi lang="latex">
\author{S.~Pepping\fnref{fn1,fn3}}
\ead[url]{http://www.elsevier.com}
\address{Central Application Management,
Elsevier, Radarweg 43, 1043 NX Amsterdam, Netherlands}
</geshi>
<geshi lang="latex">
\cortext[cor1]{Corresponding author}
\fntext[fn1]{This is the first author footnote.}
\fntext[fn2]{Another author footnote, this is a very long footnote and
it should be a really long footnote. But this footnote is not yet
sufficiently long enough to make two lines of footnote text.}
\fntext[fn3]{Yet another author footnote.}
</geshi>
Output of the above TeX sources will look like the following:
<table border="1" cellspacing="3" cellpadding="3">
<tr><td>



[[Image:Els2.png]]



</td></tr></table>
The front matter part has further environments like <code>\begin{abstract} . . . \end{abstract}</code> and <code>\begin{keyword} ... \end{keyword}</code> which contain the abstract and keywords respectively. Keywords can be marked up in the following
manner:
<geshi lang="latex">
\begin{keyword}
quadruple exiton \sep polariton \sep WGM
\PACS 71.35.-y \sep 71.35.Lk \sep 71.36.+c
\end{keyword}
</geshi>
Each keyword shall be separated by <code>\sep</code> command. PACS and MSC classifications shall be provided in the keyword environment with the commands <code>\PACS</code> and <code>\MSC</code> respectively. <code>\MSC</code> accepts an optional argument to accommodate future revisions. eg., <code>\MSC[2008]</code>. The default is 2000.

===Specimen of a title page coding===
Following is the specimen of a title page coding.
<geshi lang="latex">
\documentclass[preprint,1p,12pt]{elsarticle}

\journal{Nuclear Physics B}

\begin{document}

\begin{frontmatter}

\title{This is a specimen title\tnoteref{t1,t2}}
\tnotetext[t1]{This document is a collaborative effort.}
\tnotetext[t2]{The second title footnote which is a longer
longer than the first one and with an intention to fill
in up more than one line while formatting.}

\author[rvt]{C.V.~Radhakrishnan\corref{cor1}\fnref{fn1}}
\ead{cvr@river-valley.com}

\author[rvt,focal]{K.~Bazargan\fnref{fn2}}
\ead{kaveh@river-valley.com}

\author[els]{S.~Pepping\corref{cor2}\fnref{fn1,fn3}}
\ead[url]{http://www.elsevier.com}

\cortext[cor1]{Corresponding author}
\cortext[cor2]{Principal corresponding author}
\fntext[fn1]{This is the specimen author footnote.}
\fntext[fn2]{Another author footnote, but a little more longer.}
\fntext[fn3]{Yet another author footnote. Indeed, you can have
any number of author footnotes.}

\address[rvt]{River Valley Technologies, SJP Building,
Cotton Hills, Trivandrum, Kerala, India 695014}
\address[focal]{River Valley Technologies, 9, Browns Court,
Kennford, Exeter, United Kingdom}
\address[els]{Central Application Management,
Elsevier, Radarweg 29, 1043 NX\\
Amsterdam, Netherlands}
\begin{abstract}
In this work we demonstrate the formation of a new type of polariton on
the interface between a cuprous oxide slab and a polystyrene
micro-sphere placed on the slab. .....
\end{abstract}

\begin{keyword}
quadruple exiton \sep polariton \sep WGM
\PACS 71.35.-y \sep 71.35.Lk \sep 71.36.+c
\end{keyword}

\end{frontmatter}

\section{Introduction}\label{sec1}
Although quadrupole excitons (QE) in cuprous oxide crystals are good
candidates for BEC ......
</geshi>

==Floats==
Figures may be included using the command, <code>\includegraphics</code> in combination with or without its several options to further control the graphic. <code>\includegraphics</code> is provided by <code>graphic[s,x].sty</code> which is part of any standard LaTeX distribution.
<code>graphicx.sty</code> is loaded by default. LaTeX accepts figures in postscript format while pdfLaTeX accepts <code>*.pdf</code>, <code>*.mps</code> (metapost), <code>*.jpg</code> and <code>*.png</code> formats. pdfLaTeX does not accept graphic files in postscript format.

The table environment is handy for marking up tabular material. If users want to use <code>multirow.sty</code>, <code>array.sty</code>, etc., to fine control/enhance the tables, they are welcome to load any package of their choice and <code>elsarticle.cls</code> will work in combination with all loaded packages.

==Theorem and theorem like environments==
<code>elsarticle.cls</code> provides a few hooks to format theorems and theorem like environments with ease. In all commands the options that are used with <code>\newtheorem</code> command will work exactly in the same manner. <code>elsarticle.cls</code> provides three commands to format theorem or theorem like environments:
<geshi lang="latex">
\newtheorem{thm}{Theorem}
\newtheorem{lem}[thm]{Lemma}
\newdefinition{rmk}{Remark}
\newproof{pf}{Proof}
\newproof{pot}{Proof of Theorem \ref{thm2}}
</geshi>

<code>\newtheorem</code> command formats a theorem in LaTeX's default style with italicized font, bold font for theorem heading, theorem number at the right hand side of the theorem heading. It also optionally accepts an argument which will be printed as an extra heading in parentheses. The following text will show you how some text enclosed between <code>\begin{thm} . . . \end{thm}</code> will look like.

<table border="1" cellspacing="3" cellpadding="3">
<tr><td>

[[Image:Els3.png]]

</td></tr></table>

<code>\newdefinition</code> command is same in all respects as its <code>\newtheorem</code> counterpart except that the font shape is roman instead of italic. Both <code>\newdefinition</code> and <code>\newtheorem</code> commands automatically defines counters for the environments defined. See the output of of <code>\begin{rmk} . . . \end{rmk}</code> which is given below.

<table border="1" cellspacing="3" cellpadding="3">
<tr><td>

[[Image:Els4.png]]

</td></tr></table>

<code>\newproof</code> command is for defining proof environments with upright font shape. No counters are defined. See the output of <code>\begin{pot} . . . \end{pot}</code> which is given below.

<table border="1" cellspacing="3" cellpadding="3">
<tr><td>

[[Image:Els5.png]]

</td></tr></table>

Users can also make use of <code>amsthm.sty</code> which will override all the default definitions described above.

==Enumerated and Itemized Lists==
<code>elsarticle.cls</code> provides an extended list processing macros which makes the usage a bit more user friendly than the default LaTeX list macros. With an optional argument to the <code>\begin{enumerate}</code> command, you can change the list counter type and its attributes.
<geshi lang="latex">
\begin{enumerate}[1.]
\item The enumerate environment starts with an optional argument `1.' so that the item counter will be suffixed by a period.
\item If you provide a closing parenthesis to the number in the optional argument, the output will have closing parenthesis for all the item counters.
\item You can use `(a)' for alphabetical counter and '(i)' for roman counter.
\begin{enumerate}[a)]
\item Another level of list with alphabetical counter.
\item One more item before we start another.
\begin{enumerate}[(i)]
\item This item has roman numeral counter.
\item Another one before we close the third level.
\end{enumerate}
\item Third item in second level.
\end{enumerate}
\item All list items conclude with this step.
\end{enumerate}
</geshi>

The typeset copy of the above source code is given below:

<table border="1" cellspacing="3" cellpadding="3">
<tr><td>

[[Image:Els6.png]]

</td></tr></table>

Further, the enhanced list environment allows one to prefix a string like `step' to all the item numbers. Take a look at the example below:
<geshi lang="latex">
\begin{enumerate}[Step 1.]
\item This is the first step of the example list.
\item Obviously this is the second step.
\item The final step to wind up this example.
\end{enumerate}
</geshi>
The typeset copy of the above source code is given below:

<table border="1" cellspacing="3" cellpadding="3">
<tr><td>

[[Image:Els7.png]]

</td></tr></table>

==Cross-references==
In electronic publications articles may be internally hyperlinked. Hyperlinks are generated from proper cross-references in the article. For example, the words
<code>Fig. 1</code> will never be more than simple text, whereas the proper cross-reference <code>\ref{tiger}</code> may be turned into a hyperlink to the figure itself: <code>Fig. 1</code>. In the same way, the words <code>Ref. [1]</code> will fail to turn into a hyperlink; the proper cross-reference is <code>\cite{Knuth96}</code>. Cross-referencing is possible in LaTeX for sections, subsections, formulae, figures, tables, and literature references.

==Mathematical symbols and formulae==
Many physical/mathematical sciences authors require more mathematical symbols than the few that are provided in standard LaTeX. A useful package for
additional symbols is the <code>amssymb</code> package, developed by the American Mathematical Society. This package includes such oft used symbols as <code>\lesssim</code> for ******, <code>\gtrsim</code> for ***** or <code>\hbar</code> for *****. Note that your TeX system should have the <code>msam</code> and <code>msbm</code> fonts installed. If you need only a few symbols, such as \Box for *****, you might try the package <code>latexsym</code>.

Another point which would require authors' attention is the breaking of longer equations. When you use <code>elsarticle.cls</code> for formatting your submissions in preprint mode, the document is formatted in single column style with a text width of 384pt or 5.3in. When this document is formatted for final print and if the journal happens to be a double column journal, the text width will be reduced to 224pt at for 3+ double column and 5+ journals respectively. All the nifty fine tuning in equation breaking done by the author goes to waste in such cases. Therefore, authors are requested to check this problem by typesetting their submissions in final format as well just to see if their equations are broken at appropriate places, by changing appropriate options in the document class loading command, which is explained in section 4, Usage. This allows authors to fix any equation breaking problem before submission for publication. <code>elsarticle.cls</code> supports formatting the author submission in different types of final format. This is further discussed in section 12, Final print.

==Bibliography==
Three bibliographic style files (*.bst) are provided -- <code>elsarticle-num.bst<code>, <code>elsarticle-num-names.bst</code> and elsarticle-harv.bst -- the first one for numbered scheme, the second for numbered with new options of natbib.sty and the last one for author year scheme.

In LaTeX literature references are listed in the <code>thebibliography</code> environment. Each reference is a <code>\bibitem</code>; each <code>\bibitem</code> is identified by a label, by which it can be cited in the text: <code>\bibitem[Elson et al.(1996)]{ESG96}</code> is cited as <code>\citet{ESG96}</code>. In connection with cross-referencing and possible future hyperlinking it is not a good idea to collect more than one literature item in one <code>\bibitem</code>. The so-called Harvard or author-year style of referencing is enabled by the LaTeX package <code>natbib</code>. With this package the literature can be cited as follows:
* Parenthetical: <code>\citep{WB96}</code> produces (Wettig & Brown, 1996).
* Textual: <code>\citet{ESG96}</code> produces Elson et al. (1996).
* An affix and part of a reference: <code>\citep[e.g.][Ch. 2]{Gea97}</code> produces (e.g. Governato et al., 1997, Ch. 2).
In the numbered scheme of citation, <code>\cite{<label>}</code> is used, since <code>\citep</code> or <code>\citet</code> has no relevance in numbered scheme. <code>natbib</code> package is loaded by elsarticle with numbers as default option. You can change this to author-year or harvard scheme by adding option <code>authoryear</code> in the class loading command. If you want to use more options of the <code>natbib</code> package, you can do so with the <code>\biboptions</code> command, which is described in section 4, Usage. For details of various options of the <code>natbib</code> package, please take a look at the natbib documentation, which is part of any standard LaTeX installation.

==Final print==
Authors can format their submission to the page size and margins of their preferred journal. <code>elsarticle</code> provides four class options for the same:
;<code>1p</code>: 1+ journals with a text area of 384pt × 562pt or 13.5cm × 19.75cm or 5.3in × 7.78in, single column style only.
;<code>3p</code>: 3+ journals with a text area of 468pt × 622pt or 16.45cm × 21.9cm or 6.5in × 8.6in, single column style.
;<code>3pd</code>: 3+ with the same text area as above, double column style.
;<code>5p</code>: 5+ with text area of 522pt × 682pt or 18.35cm × 24cm or 7.22in × 9.45in, double column style only.

Following is the first page of a typical single column article.

<table border="1" cellspacing="3" cellpadding="3">
<tr><td>

[[Image:Els1.png]]

</td></tr></table>

Model 1+ and 3+ will have the same look and feel in the typeset copy when presented in this document. That is also the case with the double column 3+ and 5+ journal article pages. The only difference will be wider text width of higher models. Therefore we will look at the different portions of a typical single column journal page and that of a double column article in the final format.

Following is the first page of a typical double column article.

<table border="1" cellspacing="3" cellpadding="3">
<tr><td>

[[Image:Els9.png]]

</td></tr></table>

==Displayed equations and double column journals==
Many Elsevier journals print their text in two columns. Because the preprint layout uses a larger line width than such columns, the formulas are too wide for the line width in print. Here is an example of an equation (see equation 6) which is perfect in single column preprint format:

<table border="1" cellspacing="3" cellpadding="3">
<tr><td>

[[Image:Els10.png]]

</td></tr></table>

When this document is typeset for publication in a model 3+ journal with double columns, the equation will overlap the second column text matter if the equation is not broken at the appropriate location.

<table border="1" cellspacing="3" cellpadding="3">
<tr><td>

[[Image:Els11.png]]

</td></tr></table>

The typesetter will try to break the equation which need not necessarily be to the liking of the author or as it happens, typesetter's break point may be semantically incorrect. Therefore, authors may check their submissions for the incidence of such long equations and break the equations at the correct places so that the final typeset copy will be as they wish.

Elsarticle.cls

2009-06-17T08:27:23Z

Cvr: /* Front matter */

==Introduction==

<code>elsarticle.cls</code> is a thoroughly rewritten document class
for formatting LaTeX submissions to Elsevier journals.
The class uses the environments and commands defined in LaTeX kernel
without change to the signature so that clashes with other
contributed LaTeX packages like <code>hyperref.sty</code>,
<code>preview-latex.sty</code>, etc., will be minimal.
<code>elsarticle.cls</code> is primarily built upon the default
<code>article.cls</code>. The class depends on the following packages
for its proper functionality:

# <code>pifont.sty</code> for openstar in the title footnotes.
# <code>natbib.sty</code> for citation processing.
# <code>geometry.sty</code> for margin settings.
# <code>fleqn.clo</code> for left aligned equations.
# <code>graphicx.sty</code> for graphics inclusion.
# <code>txfonts.sty</code> optional font package, if document is to be formatted with Times and compatible math fonts.
# <code>hyperref.sty</code> optional packages if hyper linking is required in the document.

All the above packages are part of any standard LaTeX installation.
Therefore, the users need not be bothered about downloading any
extra packages. Further, users are free to make use of AMS
math packages like, <code>amsmath.sty</code>, <code>amsthm.sty</code>,
<code>amssymb.sty</code>, <code>amsfonts.sty</code>, etc., if they want. All
these packages work in tandem with <code>elsarticle.cls</code> without
any problems.

==Major Differences==

Following are the major differences between <code>elsarticle.cls</code> and its predecesor package, <code>elsart.cls</code>:
* <code>elsarticle.cls</code> is built upon <code>article.cls</code> while <code>elsart.cls</code> is not. <code>elsart.cls</code> redefines many of the commands in the LaTeX classes/kernel, which can possibly cause surprising clashes with other contributed LaTeX packages.
* Provides preprint document formatting by default, and optionally formats the document as per the final style of models <code>1+</code>, <code>3+</code> and <code>5+</code> of Elsevier journals.
* Some easier hooks for formatting <code>list</code> and <code>theorem</code> environments are provided while people can still use <code>amsthm.sty</code> package.
* <code>natbib.sty</code> is the main citation processing package which can comprehensively handle all kinds of citations and works perfectly with <code>hyperref.sty</code> in combination with <code>hypernat.sty</code>.
* Long title pages are processed correctly in preprint and final formats.

==Installation==

The package is available at [http://www.elsevier.com/locate/latex author resources page at Elsevier Science].
It can also be found in any of the nodes of the Comprehensive TeX Archive Network (CTAN), one of the primary nodes being [http://www.ctan.org/tex-archive/macros/latex/contrib/elsevier/ http://www.ctan.org]. Please grab the <code>elsarticle.dtx</code> which is the composite class with documentation and <code>elsarticle.ins</code> which is the LaTeX installer file. When we compile the <code>elsarticle.ins</code> with LaTeX it provides the class file, <code>elsarticle.cls</code> by stripping off all the documentation from the <code>*.dtx</code> file. The class may be moved or copied to a place, usually, <code>$TEXMF/tex/latex/elsevier/</code>, or a folder which will be read by LaTeX during document compilation. The TeX file database needs updation after moving/copying class file. Usually, we use commands like <code>mktexlsr</code> or <code>texhash</code> depending upon the distribution and operating system.

==Usage==

The class should be loaded with the command:
<geshi lang="latex">
\documentclass[<options>]{elsarticle}
</geshi>
where the <code>options</code> can be the following:

; <code>preprint</code>: default options which formats the document for submission to Elsevier journals.
; <code>review</code>: similar to <code>preprint</code> option, but increases the baselineskip to facilitate easier review process.
; <code>1p</code>: formats to the look and feel of the final format of model 1+ journals. This is always single column style.
; <code>3p</code>: formats to the look and feel of the final format of model 3+ journals. If the journal is a two column model use <code>twocolumn</code> option in combination.
; <code>5p</code>: formats for model 5+ journals. This is always two column style.
; <code>authoryear</code>: author-year citation style of <code>natbib.sty</code>. If you want to add extra options of <code>natbib.sty</code>, you may use the options as a comma delimited strings as argument to <code>\biboptions</code> command. An example would be:
<geshi lang="latex">
\biboptions{longnamesfirst,angle,semicolon}
</geshi>
; <code>number</code>: numbered citation style. Extra options can be loaded with <code>\biboptions</code> command.
; <code>sort&compress</code>: sorts and compresses the numbered citations. Example, citation [1,2,3] will become [1-3].
; <code>longtitle</code>: if front matter is unusually long, use this option to split the title page across pages with correct placing of title and author footnotes in the first page.
; <code>times</code>: loads <code>txfonts.sty</code> if available in the system to use Times and compatible math fonts.
* All options of <code>article.cls</code> can be used with this document class.
* The default options loaded are <code>a4paper</code>, <code>10pt</code>, <code>oneside</code>, <code>onecolumn</code> and <code>preprint</code>.

==Front matter==

There are two types of front matter coding — (1) each author is connected to an affiliation with a footnote marker; hence all
authors are grouped together and affiliations follow; (2) authors
of same affiliations are grouped together and the relevant
affiliation follows this group. An example coding of the first
type is provided below:

<geshi lang="latex">
\begin{frontmatter}
\title{This is a specimen title\tnoteref{t1,t2}}
\tnotetext[t1]{This document is a collaborative effort.}
\tnotetext[t2]{The second title footnote which is a longer
longer than the first one and with an intention to fill
in up more than one line while formatting.}

\author[rvt]{C.V.~Radhakrishnan\corref{cor1}\fnref{fn1}}
\ead{cvr@river-valley.com}

\author[rvt,focal]{K.~Bazargan\fnref{fn2}}
\ead{kaveh@river-valley.com}

\author[els]{S.~Pepping\corref{cor2}\fnref{fn1,fn3}}
\ead[url]{http://www.elsevier.com}

\cortext[cor1]{Corresponding author}
\cortext[cor2]{Principal corresponding author}
\fntext[fn1]{This is the specimen author footnote.}
\fntext[fn2]{Another author footnote, but a little more longer.}
\fntext[fn3]{Yet another author footnote. Indeed, you can have
any number of author footnotes.}

\address[rvt]{River Valley Technologies, SJP Building,
Cotton Hills, Trivandrum, Kerala, India 695014}
\address[focal]{River Valley Technologies, 9, Browns Court,
Kennford, Exeter, United Kingdom}
\address[els]{Central Application Management,
Elsevier, Radarweg 29, 1043 NX\\
Amsterdam, Netherlands}
. . .
. . .
\end{frontmatter}
</geshi>

Output of the above TeX sources will look like the following:

<table border="1" cellspacing="3" cellpadding="3">
<tr><td>



[[Image:Els1.png]]



</td></tr></table>

Most of the commands like <code>\title</code>, <code>\author</code>, <code>\address</code> are self explanatory. Various components are linked each other by a
label–reference mechanism, for instance, title footnote is linked to the title with a footnote mark generated by referring to the <code>\label</code> string of the <code>\tnotetext</code>. We have used similar commands like <code>\tnoteref</code> (to link title note to title); <code>\corref</code> (to link corresponding author text to corresponding author); <code>\fnref</code> (to link footnote text to the relevant author names). TeX needs two compilations to resolve the footnote marks in the preamble part. Given below are the syntax of various note marks and note texts.
<geshi lang="latex">
\tnoteref{<label(s)>}
\corref{<label(s)>}
\fnref{<label(s)>}
\tnotetext[<label>]{<title note text>}
\cortext[<label>]{<corresponding author note text>}
\fntext[<label>]{<author footnote text>}
</geshi>
where <code><label(s)></code> can be either one or more comma delimited
label strings. The optional arguments to the <code>\author</code>
command holds the ref label(s) of the address(es) to which the author
is affiliated while each <code>\address</code> command can have an
optional argument of a label. In the same manner,
<code>\tnotetext</code>, <code>\fntext</code>, <code>\cortext</code>
will have optional arguments as their respective labels and note text
as their mandatory argument.

The following example code provides the markup of the second type of
author-affiliation.
<geshi lang="latex">
\author{C.V.~Radhakrishnan\corref{cor1}\fnref{fn1}}
\ead{cvr@river-valley.com}
\address{River Valley Technologies, SJP Building,
Cotton Hills, Trivandrum, Kerala, India 695014}
</geshi>
<geshi lang="latex">
\author{K.~Bazargan\fnref{fn2}}
\ead{kaveh@river-valley.com}
\address{River Valley Technologies, 9, Browns Court, Kennford,
Exeter, United Kingdom}
</geshi>
<geshi lang="latex">
\author{S.~Pepping\fnref{fn1,fn3}}
\ead[url]{http://www.elsevier.com}
\address{Central Application Management,
Elsevier, Radarweg 43, 1043 NX Amsterdam, Netherlands}
</geshi>
<geshi lang="latex">
\cortext[cor1]{Corresponding author}
\fntext[fn1]{This is the first author footnote.}
\fntext[fn2]{Another author footnote, this is a very long footnote and
it should be a really long footnote. But this footnote is not yet
sufficiently long enough to make two lines of footnote text.}
\fntext[fn3]{Yet another author footnote.}
</geshi>
Output of the above TeX sources will look like the following:
<table border="1" cellspacing="3" cellpadding="3">
<tr><td>



[[Image:Els2.png]]



</td></tr></table>
The front matter part has further environments like <code>\begin{abstract} . . . \end{abstract}</code> and <code>\begin{keyword} ... \end{keyword}</code> which contain the abstract and keywords respectively. Keywords can be marked up in the following
manner:
<geshi lang="latex">
\begin{keyword}
quadruple exiton \sep polariton \sep WGM
\PACS 71.35.-y \sep 71.35.Lk \sep 71.36.+c
\end{keyword}
</geshi>
Each keyword shall be separated by <code>\sep</code> command. PACS and MSC classifications shall be provided in the keyword environment with the commands <code>\PACS</code> and <code>\MSC</code> respectively. <code>\MSC</code> accepts an optional argument to accommodate future revisions. eg., <code>\MSC[2008]</code>. The default is 2000.

===Specimen of a title page coding===
Following is the specimen of a title page coding.
<geshi lang="latex">
\documentclass[preprint,1p,12pt]{elsarticle}

\journal{Nuclear Physics B}

\begin{document}

\begin{frontmatter}

\title{This is a specimen title\tnoteref{t1,t2}}
\tnotetext[t1]{This document is a collaborative effort.}
\tnotetext[t2]{The second title footnote which is a longer
longer than the first one and with an intention to fill
in up more than one line while formatting.}

\author[rvt]{C.V.~Radhakrishnan\corref{cor1}\fnref{fn1}}
\ead{cvr@river-valley.com}

\author[rvt,focal]{K.~Bazargan\fnref{fn2}}
\ead{kaveh@river-valley.com}

\author[els]{S.~Pepping\corref{cor2}\fnref{fn1,fn3}}
\ead[url]{http://www.elsevier.com}

\cortext[cor1]{Corresponding author}
\cortext[cor2]{Principal corresponding author}
\fntext[fn1]{This is the specimen author footnote.}
\fntext[fn2]{Another author footnote, but a little more longer.}
\fntext[fn3]{Yet another author footnote. Indeed, you can have
any number of author footnotes.}

\address[rvt]{River Valley Technologies, SJP Building,
Cotton Hills, Trivandrum, Kerala, India 695014}
\address[focal]{River Valley Technologies, 9, Browns Court,
Kennford, Exeter, United Kingdom}
\address[els]{Central Application Management,
Elsevier, Radarweg 29, 1043 NX\\
Amsterdam, Netherlands}
\begin{abstract}
In this work we demonstrate the formation of a new type of polariton on
the interface between a cuprous oxide slab and a polystyrene
micro-sphere placed on the slab. .....
\end{abstract}

\begin{keyword}
quadruple exiton \sep polariton \sep WGM
\PACS 71.35.-y \sep 71.35.Lk \sep 71.36.+c
\end{keyword}

\end{frontmatter}

\section{Introduction}\label{sec1}
Although quadrupole excitons (QE) in cuprous oxide crystals are good
candidates for BEC ......
</geshi>

==Floats==
Figures may be included using the command, <code>\includegraphics</code> in combination with or without its several options to further control the graphic. <code>\includegraphics</code> is provided by <code>graphic[s,x].sty</code> which is part of any standard LaTeX distribution.
<code>graphicx.sty</code> is loaded by default. LaTeX accepts figures in postscript format while pdfLaTeX accepts <code>*.pdf</code>, <code>*.mps</code> (metapost), <code>*.jpg</code> and <code>*.png</code> formats. pdfLaTeX does not accept graphic files in postscript format.

The table environment is handy for marking up tabular material. If users want to use <code>multirow.sty</code>, <code>array.sty</code>, etc., to fine control/enhance the tables, they are welcome to load any package of their choice and <code>elsarticle.cls</code> will work in combination with all loaded packages.

==Theorem and theorem like environments==
<code>elsarticle.cls</code> provides a few hooks to format theorems and theorem like environments with ease. In all commands the options that are used with <code>\newtheorem</code> command will work exactly in the same manner. <code>elsarticle.cls</code> provides three commands to format theorem or theorem like environments:
<geshi lang="latex">
\newtheorem{thm}{Theorem}
\newtheorem{lem}[thm]{Lemma}
\newdefinition{rmk}{Remark}
\newproof{pf}{Proof}
\newproof{pot}{Proof of Theorem \ref{thm2}}
</geshi>

<code>\newtheorem</code> command formats a theorem in LaTeX's default style with italicized font, bold font for theorem heading, theorem number at the right hand side of the theorem heading. It also optionally accepts an argument which will be printed as an extra heading in parentheses. The following text will show you how some text enclosed between <code>\begin{thm} . . . \end{thm}</code> will look like.

<table border="1" cellspacing="3" cellpadding="3">
<tr><td>

[[Image:Els3.png]]

</td></tr></table>

<code>\newdefinition</code> command is same in all respects as its <code>\newtheorem</code> counterpart except that the font shape is roman instead of italic. Both <code>\newdefinition</code> and <code>\newtheorem</code> commands automatically defines counters for the environments defined. See the output of of <code>\begin{rmk} . . . \end{rmk}</code> which is given below.

<table border="1" cellspacing="3" cellpadding="3">
<tr><td>

[[Image:Els4.png]]

</td></tr></table>

<code>\newproof</code> command is for defining proof environments with upright font shape. No counters are defined. See the output of <code>\begin{pot} . . . \end{pot}</code> which is given below.

<table border="1" cellspacing="3" cellpadding="3">
<tr><td>

[[Image:Els5.png]]

</td></tr></table>

Users can also make use of <code>amsthm.sty</code> which will override all the default definitions described above.

==Enumerated and Itemized Lists==
<code>elsarticle.cls</code> provides an extended list processing macros which makes the usage a bit more user friendly than the default LaTeX list macros. With an optional argument to the <code>\begin{enumerate}</code> command, you can change the list counter type and its attributes.
<geshi lang="latex">
\begin{enumerate}[1.]
\item The enumerate environment starts with an optional argument `1.' so that the item counter will be suffixed by a period.
\item If you provide a closing parenthesis to the number in the optional argument, the output will have closing parenthesis for all the item counters.
\item You can use `(a)' for alphabetical counter and '(i)' for roman counter.
\begin{enumerate}[a)]
\item Another level of list with alphabetical counter.
\item One more item before we start another.
\begin{enumerate}[(i)]
\item This item has roman numeral counter.
\item Another one before we close the third level.
\end{enumerate}
\item Third item in second level.
\end{enumerate}
\item All list items conclude with this step.
\end{enumerate}
</geshi>

The typeset copy of the above source code is given below:

<table border="1" cellspacing="3" cellpadding="3">
<tr><td>

[[Image:Els6.png]]

</td></tr></table>

Further, the enhanced list environment allows one to prefix a string like `step' to all the item numbers. Take a look at the example below:
<geshi lang="latex">
\begin{enumerate}[Step 1.]
\item This is the first step of the example list.
\item Obviously this is the second step.
\item The final step to wind up this example.
\end{enumerate}
</geshi>
The typeset copy of the above source code is given below:

<table border="1" cellspacing="3" cellpadding="3">
<tr><td>

[[Image:Els7.png]]

</td></tr></table>

==Cross-references==
In electronic publications articles may be internally hyperlinked. Hyperlinks are generated from proper cross-references in the article. For example, the words
<code>Fig. 1</code> will never be more than simple text, whereas the proper cross-reference <code>\ref{tiger}</code> may be turned into a hyperlink to the figure itself: <code>Fig. 1</code>. In the same way, the words <code>Ref. [1]<code> will fail to turn into a hyperlink; the proper cross-reference is <code>\cite{Knuth96}</code>. Cross-referencing is possible in LaTeX for sections, subsections, formulae, figures, tables, and literature references.

==Mathematical symbols and formulae==
Many physical/mathematical sciences authors require more mathematical symbols than the few that are provided in standard LaTeX. A useful package for
additional symbols is the <code>amssymb</code> package, developed by the American Mathematical Society. This package includes such oft used symbols as <code>\lesssim</code> for ******, <code>\gtrsim</code> for ***** or <code>\hbar</code> for *****. Note that your TeX system should have the <code>msam</code> and <code>msbm</code> fonts installed. If you need only a few symbols, such as \Box for *****, you might try the package <code>latexsym</code>.

Another point which would require authors' attention is the breaking of longer equations. When you use <code>elsarticle.cls</code> for formatting your submissions in preprint mode, the document is formatted in single column style with a text width of 384pt or 5.3in. When this document is formatted for final print and if the journal happens to be a double column journal, the text width will be reduced to 224pt at for 3+ double column and 5+ journals respectively. All the nifty fine tuning in equation breaking done by the author goes to waste in such cases. Therefore, authors are requested to check this problem by typesetting their submissions in final format as well just to see if their equations are broken at appropriate places, by changing appropriate options in the document class loading command, which is explained in section 4, Usage. This allows authors to fix any equation breaking problem before submission for publication. <code>elsarticle.cls</code> supports formatting the author submission in different types of final format. This is further discussed in section 12, Final print.

==Bibliography==
Three bibliographic style files (*.bst) are provided -- <code>elsarticle-num.bst<code>, <code>elsarticle-num-names.bst</code> and elsarticle-harv.bst -- the first one for numbered scheme, the second for numbered with new options of natbib.sty and the last one for author year scheme.

In LaTeX literature references are listed in the <code>thebibliography</code> environment. Each reference is a <code>\bibitem</code>; each <code>\bibitem</code> is identified by a label, by which it can be cited in the text: <code>\bibitem[Elson et al.(1996)]{ESG96}</code> is cited as <code>\citet{ESG96}</code>. In connection with cross-referencing and possible future hyperlinking it is not a good idea to collect more than one literature item in one <code>\bibitem</code>. The so-called Harvard or author-year style of referencing is enabled by the LaTeX package <code>natbib</code>. With this package the literature can be cited as follows:
* Parenthetical: <code>\citep{WB96}</code> produces (Wettig & Brown, 1996).
* Textual: <code>\citet{ESG96}</code> produces Elson et al. (1996).
* An affix and part of a reference: <code>\citep[e.g.][Ch. 2]{Gea97}</code> produces (e.g. Governato et al., 1997, Ch. 2).
In the numbered scheme of citation, <code>\cite{<label>}</code> is used, since <code>\citep</code> or <code>\citet</code> has no relevance in numbered scheme. <code>natbib</code> package is loaded by elsarticle with numbers as default option. You can change this to author-year or harvard scheme by adding option <code>authoryear</code> in the class loading command. If you want to use more options of the <code>natbib</code> package, you can do so with the <code>\biboptions</code> command, which is described in section 4, Usage. For details of various options of the <code>natbib</code> package, please take a look at the natbib documentation, which is part of any standard LaTeX installation.

==Final print==
Authors can format their submission to the page size and margins of their preferred journal. <code>elsarticle</code> provides four class options for the same:
;<code>1p</code>: 1+ journals with a text area of 384pt × 562pt or 13.5cm × 19.75cm or 5.3in × 7.78in, single column style only.
;<code>3p</code>: 3+ journals with a text area of 468pt × 622pt or 16.45cm × 21.9cm or 6.5in × 8.6in, single column style.
;<code>3pd</code>: 3+ with the same text area as above, double column style.
;<code>5p</code>: 5+ with text area of 522pt × 682pt or 18.35cm × 24cm or 7.22in × 9.45in, double column style only.

Following is the first page of a typical single column article.

<table border="1" cellspacing="3" cellpadding="3">
<tr><td>

[[Image:Els1.png]]

</td></tr></table>

Model 1+ and 3+ will have the same look and feel in the typeset copy when presented in this document. That is also the case with the double column 3+ and 5+ journal article pages. The only difference will be wider text width of higher models. Therefore we will look at the different portions of a typical single column journal page and that of a double column article in the final format.

Following is the first page of a typical double column article.

<table border="1" cellspacing="3" cellpadding="3">
<tr><td>

[[Image:Els9.png]]

</td></tr></table>

==Displayed equations and double column journals==
Many Elsevier journals print their text in two columns. Because the preprint layout uses a larger line width than such columns, the formulas are too wide for the line width in print. Here is an example of an equation (see equation 6) which is perfect in single column preprint format:

<table border="1" cellspacing="3" cellpadding="3">
<tr><td>

[[Image:Els10.png]]

</td></tr></table>

When this document is typeset for publication in a model 3+ journal with double columns, the equation will overlap the second column text matter if the equation is not broken at the appropriate location.

<table border="1" cellspacing="3" cellpadding="3">
<tr><td>

[[Image:Els11.png]]

</td></tr></table>

The typesetter will try to break the equation which need not necessarily be to the liking of the author or as it happens, typesetter's break point may be semantically incorrect. Therefore, authors may check their submissions for the incidence of such long equations and break the equations at the correct places so that the final typeset copy will be as they wish.

2008-08-07T11:54:50Z

Cvr: /* Support at River Valley */

==Support at River Valley==

This is the main support page of [http://www.river-valley.com River Valley Technologies]. Currently we have started adding support documentation for the following:

*[[Elsarticle.cls|Author support for <code>elsarticle.cls</code>]]
*[[adnd.sty|Author support for <code>adnd.sty</code>, auxiliary package for Journal of Atomic and Nuclear Data Tables]]

None of the above are completed yet, but will hopefully be finished before long. A frequently asked questions (FAQ) is on the cards which will be based on the queries posted by authors to the support network. Both the above documentation should be of assistance to authors since these are always available online. Another point is that since it is in a Wiki, updating takes only minimal effort, meaning, this documentation will receive constant updates.

* [[PDF annotators|Open source tools to annotate PDF's]]

PDF annotators

2008-08-07T11:12:53Z

Cvr: /* General notes */